Built on WIX Headless

Tutorials / tutorial

How to Customize Wix Harmony Repeater Cards: Horizontal Layouts, Images and Buttons

· customize Wix Harmony Repeater cards

How to Customize Wix Harmony Repeater Cards: Horizontal Layouts, Images and Buttons

Connecting a collection to the Repeater is only half the job. The other half is the layout inside each card—where the image sits, how dates and buttons align, and what happens when a description is long or a field is empty.

The short setup checklist is How to make a card grid from CMS. This guide is the practical companion: grid vs in-card layout, three worked examples, image fit, clipping, empty states, buttons, and mobile—without wiping a design you already like.

Grid of cards vs layout inside each card

LayerWhat it controlsWhere in the panel
Repeater layoutHow many cards per row, gaps, list vs gridLayout → Repeater layout
Card layoutArrangement of fields inside one cardLayout → Card layout (Preset or Custom → Arrange fields)
FormattingPer-field empty behavior, number/date display, image-related optionsFormatting
Design / MobileChrome, typography, mobile breakpoint behaviorDesign, Mobile

Changing columns on the page does not by itself create a horizontal “row” inside a card. For event schedules, property teases, and job rows, you usually need Custom card layout (or a preset that already matches).

Docs: Repeater · Field formatting.

Sample collection fields (shared ideas)

Most card designs reuse a small set:

Worked example 1 — Horizontal event row

Goal: Each race or event reads left → right: date, title + venue, DETAILS button—not a product-style image gallery.

  1. Connect an Events (or Schedule) collection.
  2. Under Layout, set Card layout to Custom and open Arrange fields.
  3. Place Event date on the left, title and short details in the middle, and a DETAILS control (Dynamic Page link or URL) on the right.
  4. Prefer a List or single-column Repeater layout when each card should feel like a full-width row.
  5. In Formatting, set long Description to collapse or hide on the card; put the full text in Quick view or the item page.

Worked example 2 — Property card

Goal: Photo on top (or left), price and beds/baths scannable, Inquire or View button.

  1. Map Cover image, Title/address, Price, Beds, Baths, City.
  2. Use a Grid Repeater layout with consistent card width.
  3. On the image field (or card background), set Fit to Cover for cropped hero photos; use Contain when you must show the full floor plan without cropping.
  4. Set aspect ratio / sizing so every card’s media block is the same height—mixed ratios make the grid look uneven.
  5. Link the card or a button to the Dynamic Page listing URL.

Industry walkthrough: Real estate listings.

Worked example 3 — Job listing card

Goal: Title, employer, location, employment type, Apply button—dense and readable.

  1. Map Title, Employer, Location, Employment type; keep Description short on the card.
  2. Custom-arrange so Apply sits consistently (often bottom or right).
  3. Use When empty on optional Salary so missing values collapse instead of leaving a blank gap.
  4. Pair with fixed publication filters from the job board guide.

Images: contain vs cover, aspect ratios, sizing

FitBest for
CoverLifestyle photos, property heroes, product shots where crop is OK
ContainLogos, diagrams, full vehicle side views you must not crop
StretchRare—only when distortion is acceptable

Tips:

Long text, clipping, empty fields, buttons

  1. Long descriptions — Show a short summary field on the card; put the full body in Quick view or the item page. Clip or truncate only when you intentionally want a teaser.
  2. Empty fields — In Formatting, use When empty: Collapse (preferred for optional salary/location), Hide (keep space), or Show placeholder.
  3. Buttons — Keep Apply / Details / Inquire in the same place on every card. Dynamic Page buttons stay tied to that action when you reorder other fields.
  4. Targeted edits — Change one field’s Formatting or rearrange Custom placement without reconnecting the collection or clearing Search & filters. Avoid “start over” unless the card structure is wrong end-to-end.

Mobile layouts

  1. Open Mobile on the Repeater.
  2. Choose whether to keep the desktop arrangement or simplify (stack fields, fewer columns).
  3. Set the Breakpoint where the mobile layout starts.
  4. On a phone-width preview, check that buttons stay tappable and horizontal desktop rows do not crush text.

Optional AI setup shortcut

AI setup can propose field order and a starting layout from a prompt (“horizontal event row with date left and Details right”). Use it to draft, then refine with Arrange fields and Formatting. Re-check mobile after any AI apply.

Live-site verification checklist

  1. Publish and open the page on desktop—card interiors match the intended pattern (row vs stacked product card).
  2. Spot-check three items with missing optional fields—no awkward empty gaps if you chose Collapse.
  3. Confirm image fit (no unexpected crops or letterboxing).
  4. Resize to mobile width—layout switches cleanly; buttons remain usable.
  5. Click Details / Apply / item links on two different cards.

FAQ

Is Cards a separate widget?

No—in CMS for Harmony, “cards” means a Repeater layout.

Will Custom layout reset my filters?

No. Arrange fields changes in-card placement. Search & filters and collection connection stay unless you change those sections yourself.

Can each card use a CMS image or video as the background?

Yes—set Card background from an image or video field, then choose Fit, Focus, and Fallback color. Cover vs Contain and empty-field behavior are configured under Layout / Formatting on the same Repeater.

Ready to try it on Harmony? Get a free starter site CMS for Harmony