Built on WIX Headless

Docs Features Field formatting

Field formatting

Per-field display options on Repeater, Dynamic Page, and Table — Address maps, Color swatches, video playback, references, and empty states.

Field formatting controls how each selected field appears on the live widget — empty states, Address maps, Color swatches, video playback, reference labels, and date formats.

Which widgets

WidgetPanel section
RepeaterFormatting
Dynamic PageFormatting
TableLayout & Formatting (per column)

Slideshow, Media Gallery, and Calendar use field mapping and their own layout/design sections instead of this shared Formatting accordion. Video playback for those widgets lives under Dynamic page (or Content) where image/video clicks are configured.

Configure formatting

Where: Settings → Formatting (or Layout & Formatting on Table) → expand a field by its display name

Requires fields (or columns) selected in Content. Each selected field gets its own row. You can reorder fields here on Repeater (except a Dynamic page button, which stays with that action).

Common controls

ControlWhen it appearsWhat it does
When emptyMost fieldsCollapse, Hide (keep space), or Show placeholder
Display asAddress, Color, Number, …How the value is rendered
Video playbackVideo / gallery videoOpen in modal, Play on click, or Autoplay (muted)
Show timezoneDate & timeAppends the visitor’s local timezone abbreviation
Display fieldReference / Multi-referenceWhich related-collection field is the label

Address fields

  1. Expand the Address field.
  2. Set Display as to Text, Map, or Text and map.
  3. For map modes, set Map height. Map needs coordinates on the value; otherwise the widget falls back to text when available.

Video fields

  1. Expand the Video field (or a gallery that includes video).
  2. Set Video playback to Open in modal, Play on click, or Autoplay (muted).

Forms can upload video; displays play it with these options.

Color fields

  1. Expand the Color field.
  2. Set Display as to Swatch, Hex, or Swatch and hex.
  3. Optionally adjust Swatch size.

Color fields can also power Search & filters with Color swatches.

Reference fields

  1. Expand the Reference / Multi-reference field.
  2. Choose Display field from the related collection for the label shown on the page.
  3. When that Display field is a Date & time, Number, Boolean, or other formattable type, the same Format, Day of week, and Show timezone controls appear as for a native field of that type — so related-item labels match how you format dates and numbers elsewhere.

Date & time fields

  1. Expand the Date & time field.
  2. Pick a Format, optional Day of week, and turn on Show timezone when you want the local abbreviation (for example EST or GMT+2).

Notes

  • Display options must match the field type. Unsupported combinations fall back gracefully when possible.
  • Quick view popups use the same formatting ideas for fields shown in the overlay. Image fields there also have Size, Fit, Focus, Borders, and related frame controls — see Quick view → Image Size & Fit.

FAQ

Where do I set field formatting?

In each widget’s Formatting or Layout & Formatting section (and Quick view Formatting, including image Size / Fit / Focus).

Do Reference labels use formatting?

Yes — Display field labels can inherit date, number, and timezone formats.

Does formatting apply on external databases?

Display options follow the mapped field types from the connection.