Cover Images
Add featured images to your items to make them visually engaging.
Adding a Cover Image to Items
Cover images appear at the top of each item in List and Cards layouts (not available for Table layout).
Open the Items tab
- Open your widget in the Creator
- Go to the Items tab
- Find the Cover Image section
Select an image column
Choose which column from your data source contains the images.
Configure display options
Adjust aspect ratio, image fit, and corners to match your design.
Cover Image Settings
| Setting | Options |
|---|---|
| Column | Select the column containing your images |
| Aspect ratio | 1:1 (square), 4:3, 16:9 (widescreen) |
| Image fit | Cover (fill and crop), Contain (show full image) |
| Corners | None, Small, Medium, Large |
The Corners setting is hidden for Cards layout when the item container is enabled, as the container controls the corner radius instead.
Cards layout tip: You can position badges to overlay the cover image. Go to the Badges section and set the position to “In cover image” to display badges on top of your images.
Aspect Ratios
| Ratio | Best for |
|---|---|
| 1:1 (Square) | Products, profiles, icons |
| 4:3 | Traditional photos, thumbnails |
| 16:9 | Landscape images, video thumbnails, banners |
Image Fit Options
Cover
Images fill the entire space, cropping edges if necessary to maintain the aspect ratio.
Best when:
- You want a consistent, uniform appearance
- Images are similar in composition
- Edge content isn’t critical
Contain
Images display in full without cropping, with letterboxing if the aspect ratio doesn’t match.
Best when:
- The full image must be visible
- Images have important content at the edges
- You have varying image sizes
Adding a Cover Image to Details Pages
Details pages have their own cover image settings, allowing you to display images differently than the item list.
Open the Details tab
- Open your widget in the Creator
- Go to the Details tab
- Make sure the details page is enabled
- Find the Cover Image section
Configure the cover image
Select a column and adjust the same display options: aspect ratio, image fit, and corners.
You can use the same image column for both items and details, but with different display settings — for example, a 1:1 crop on the item list and a 16:9 crop on the details page.