> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bragbox.one/llms.txt
> Use this file to discover all available pages before exploring further.

# Widget Appearance

> Configure your widget's layout, theme, and style from the BragBox dashboard.

Widget Appearance lets you control how the BragBox widget looks and behaves — from your dashboard. No code changes needed. Settings take effect immediately wherever your widget is embedded.

Go to **Settings → Widget Appearance** to configure.

## Layout

Choose how testimonials are displayed:

| Layout       | Description                                                                               |
| ------------ | ----------------------------------------------------------------------------------------- |
| **Marquee**  | Horizontal auto-scrolling strip. The default. Works well in any section.                  |
| **Carousel** | One testimonial at a time, auto-advancing every 7 seconds. Focused and minimal.           |
| **Wall**     | Masonry grid showing all testimonials at once. Great for a dedicated "Wall of Love" page. |

## Theme

| Theme      | Description                                                                     |
| ---------- | ------------------------------------------------------------------------------- |
| **Light**  | White background, dark text. Works on most sites.                               |
| **Dark**   | Dark background, light text. Pairs well with dark-mode or dark-section designs. |
| **System** | Follows the visitor's OS preference.                                            |

## Accent Color

Controls the highlight color used in the widget (button focus rings, active dots). Pick from zinc, blue, violet, emerald, rose, or amber.

## Max testimonials shown

The maximum number of testimonials rendered in the widget. Accepts 1–50. The widget pulls the most recently approved testimonials up to this limit.

## Allowed Domains

Optionally restrict which domains can embed your widget. Enter a comma-separated list of hostnames (e.g. `yoursite.com, app.yoursite.com`). Leave blank to allow all domains.

<Warning>
  Allowed Domains is a display-level hint for future referrer-checking. It does not currently block requests at the API level — full enforcement is coming in a future release.
</Warning>

## Per-page overrides

Dashboard settings are the default. If you need a different layout or theme on a specific page, use `data-*` attributes on the script tag — they take precedence over dashboard settings for that embed only.

```html theme={null}
<!-- Uses dark theme + carousel only on this page -->
<script async src="https://bragbox.one/widget.js"
  data-bragbox-id="your-widget-id"
  data-layout="carousel"
  data-theme="dark"></script>
```

See [Embed Widget](/publishing/embed-widget) for the full attribute reference.

## Multiple campaigns

If you have more than one campaign, a dropdown appears at the top of the Widget Appearance panel so you can configure each campaign's widget independently.