All docs

Social Proof

UGC carousel

Section handle: ugc-carousel

Settings

Content

SettingTypeDefaultDescription
EyebrowTextCommunity—
HeadingTextCustomer photos—
SubheadingRich text——

Layout

SettingTypeDefaultDescription
Media aspect ratioDropdownportraitShapes the media frame on phones and tablets. On desktop the frame has a fixed height and media is cropped to fit. · Options: square – Square (1:1), portrait – Portrait (4:5), vertical – Vertical (9:16)
Show arrowsToggle (on/off)OnPrevious and next buttons. Only shown when there are two or more entries.
Show entry indexToggle (on/off)OnA numbered row of thumbnails under the featured entry, one per entry. Only shown when there are two or more entries.

Style

SettingTypeDefaultDescription
Grayscale mediaToggle (on/off)OffShows images and videos in black and white. They return to color when hovered with a mouse.
Enable video sound toggleToggle (on/off)OffAdds a sound on/off button to videos. Videos always start muted.

Blocks

UGC item

Block type: ugc

Content

SettingTypeDefaultDescription
Media typeDropdownimageEntries missing the matching image or video are hidden on the storefront. · Options: image – Image, video – Video
ImageImage—Required for image entries. For video entries, used as the cover image when the video has none.
Image alt textText—Describes the image for screen readers. Blank uses the alt text saved with the image in Files.
Hosted videoVideo—Plays muted and on loop while on screen. Visitors can pause it, and it starts paused for visitors who have reduced motion turned on.
Username / handleText——
CaptionText——
Star ratingSlider0Stars out of 5. Set to 0 to hide the rating. · Min: 0 · Max: 5
Verified buyerToggle (on/off)OffShows Verified buyer on the entry; when off it shows Community post. Only turn on when you have confirmed the purchase.
Platform iconDropdown—Shows the platform's icon and name on the media. · Options: `` – None, instagram – Instagram, tiktok – TikTok, youtube – YouTube, pinterest – Pinterest, facebook – Facebook, x – X, linkedin – LinkedIn, snapchat – Snapchat, bluesky – Bluesky
Product in the frameProduct—Optional. Shows the product beside the post, and links to it when no button link is set.
Button labelText—Blank uses Shop and the product name when a product is chosen. With no product, blank hides the link.
Button linkURL / Link—Blank links to the chosen product. With no product and no link, the link is hidden.

Default Configuration

When you add this section from the Theme Editor, it comes pre-configured with:

  • UGC carousel — default settings, no pre-added blocks