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").