> ## Documentation Index > Fetch the complete documentation index at: https://kudoswall.org/llms.txt > Use this file to discover all available pages before exploring further. # Widget settings reference > Complete reference for every setting available when creating or editing a KudosWall widget — layout, filtering, branding, and more. This page is a complete reference for all settings available when you create or edit a widget in KudosWall. You can reach these settings from **Dashboard → Widgets → \[your widget] → Edit**. Settings are saved automatically as you make changes. Where a setting is marked **Pro**, it requires a Pro, Agency, or Lifetime plan. ## Layout & display These settings control how testimonial cards are arranged and what information appears on each card. | Setting | Type | Default | Description | | --------------------- | -------------------------------------- | -------- | -------------------------------------------------------------------------------- | | `layout` | `grid` \| `masonry` \| `carousel` | `grid` | Card layout style. Masonry and carousel require Pro. | | `theme` | `light` \| `dark` \| `auto` | `light` | Color scheme for the widget. `auto` follows the visitor's OS preference. | | `maxItems` | number | `20` | Maximum number of testimonials to display at once. | | `showRating` | boolean | `true` | Show star ratings on each card. | | `showReviewerPhoto` | boolean | `true` | Show the author's avatar on each card. | | `showReviewerCompany` | boolean | `true` | Show the company name below the author's name. | | `showDate` | boolean | `true` | Show the submission date on each card. | | `truncateText` | `"off"` \| number | `"off"` | Truncate testimonial text to N characters. Set to `"off"` to show the full text. | | `columnsOverride` | number \| null | `null` | Force a fixed number of columns, overriding the responsive default. | | `cardBorderRadius` | `none` \| `small` \| `large` \| `pill` | `small` | Corner rounding applied to each testimonial card. | | `cardShadow` | `none` \| `subtle` \| `medium` | `subtle` | Drop shadow intensity on cards. | ## Carousel options (Pro) These settings only apply when `layout` is set to `carousel`. They require a Pro, Agency, or Lifetime plan. | Setting | Type | Default | Description | | --------------------- | ------- | ------- | ------------------------------------------------------ | | `carouselAutoAdvance` | boolean | — | Automatically advance to the next slide on a timer. | | `carouselInterval` | number | — | Milliseconds between auto-advance steps. | | `carouselShowArrows` | boolean | — | Show left and right navigation arrows on the carousel. | ## Header The widget header appears above your testimonial cards. You can hide it entirely or customize its content. | Setting | Type | Default | Description | | ------------------- | ------- | -------------------------- | ------------------------------------------------------------------------------ | | `hideHeader` | boolean | `false` | Remove the widget header section entirely. | | `headerTitle` | string | `"What our customers say"` | Heading text displayed above the testimonials. | | `headerAutoStats` | boolean | `true` | Automatically compute and display the average star rating and total count. | | `headerRating` | number | — | Manual average rating to display. Only used when `headerAutoStats` is `false`. | | `headerReviewCount` | number | — | Manual review count to display. Only used when `headerAutoStats` is `false`. | ## Filtering & curation Use these settings to control which testimonials appear in the widget. Filters are applied at load time, so the widget only fetches matching testimonials. | Setting | Type | Default | Description | | ----------------- | -------------------------- | ------- | ------------------------------------------------------------------------------------- | | `filterTags` | string\[] | — | Only show testimonials that have at least one of these tags. Leave empty to show all. | | `filterMinRating` | number | — | Only include testimonials with a star rating at or above this value. | | `filterType` | `all` \| `text` \| `video` | `all` | Filter by testimonial type. | | `pinnedIds` | string\[] | — | Testimonial IDs that always appear first, regardless of sort order. | | `excludedIds` | string\[] | — | Testimonial IDs to never show in this widget. | You can find a testimonial's ID by opening it in Dashboard → Testimonials and copying the ID from the URL. ## Branding Customize colors and remove the KudosWall badge to match your brand. Most branding options require Pro. | Setting | Type | Default | Description | | ----------------- | -------------------- | --------------- | -------------------------------------------------------------------------- | | `accentColor` | string (hex) | `"#e8527a"` | Color used for star ratings and interactive highlights. | | `backgroundColor` | string (hex) | `"transparent"` | Background color for the widget container. | | `textColor` | string (hex) \| null | — | Override the testimonial text color. Leave unset to inherit from the page. | | `hideBadge` | boolean | `false` | Remove the "Powered by KudosWall" badge. Requires Pro. | ## Advanced Fine-tune animations, typography, and date formatting. | Setting | Type | Default | Description | | ---------------- | ---------------- | -------- | ------------------------------------------------------------------------------ | | `animation` | `fade` \| `none` | `fade` | Entrance animation for testimonial cards when they load. | | `fontFamily` | string | `"sans"` | Font family used for all text in the widget. | | `customFontUrl` | string | — | URL to a `.woff2` custom font file. Used when `fontFamily` is set to `custom`. | | `customFontName` | string | — | Display name for the custom font. | | `locale` | string | `"en"` | Locale code used to format submission dates (e.g. `"fr"`, `"de"`, `"ja"`). |