Field Composer

The Field Composer is a drag-and-drop editor inside the Finder Builder for choosing which fields appear on location cards and exactly where they sit. No code required — you drag fields into zones, toggle them on or off, and see your changes in the Live Preview as you work.

How to access

Open a Finder in the Finder Builder and click Fields in the sidebar. You can also navigate directly to /app/finders/{id}/fields.

Plan availability

Field Composer is available on eligible plan tiers. If the Fields section is not visible in your sidebar, check your plan on the Billing page.

The card layout

Every location card is divided into six zones. Fields placed in a zone render in that region of the card.

Built-in fields

These fields come from the core Location data model and are available in every Finder:

• Title — the Location name
• Address — full formatted address, or individual components (street, city/state, country)
• Distance — visitor’s distance from the Location (requires geolocation or search)
• Phone — click-to-call link
• Website — configurable display (see Field options)
• Email — mailto link
• Image — Location photo
• Hours — configurable display (see Field options)
• Tags — the Location’s tag labels
• Directions — a link that opens directions in the visitor’s maps app

Custom Fields

Any Custom Fields defined for your Workspace appear in the field library alongside the built-in fields. Drag them into any zone exactly like built-in fields.

Creating a Custom Field from within Field Composer

If you need a field that doesn’t exist yet:

1. In the field library panel, click Create field.
2. Enter a display label and a machine name (lowercase letters, numbers, underscores).
3. Choose a type: text, textarea, number, select, url, email, or image.
4. For select fields, add the available options.
5. Click Create.

The new field is immediately available in the library and can be dragged into any zone. It is also now available on every Location in your Workspace.

Placing and reordering fields

Add a field to a zone: Drag it from the field library into the target zone.

Reorder within a zone: Drag fields up or down within the zone to change their rendering order.

Move between zones: Drag a field from its current zone to a different one, or use the zone dropdown in the field inspector.

Remove from the card: Drag the field back to the library, or toggle it off with the visibility switch. Hidden fields remain in your configuration and can be re-enabled at any time.

Field options

Some fields have type-specific display options you can configure in the field inspector.

Website field

Hours field

For the full list display, you can also choose how days expand:

• Today accordion — shows today’s hours by default; expand for the rest
• All expanded — all seven days visible at once

Live preview interaction

The Live Preview in the Finder Builder is fully interactive while Field Composer is active. You can work directly on the card rather than through the panel:

• Click any field on the card to open the field inspector. A toolbar appears with shortcuts to typography, colors, move, and settings.
• Drag fields between zones directly on the card. Drop zones highlight as you hover.
• Hidden fields appear as a collapsed pill at the bottom of the card. Drag from the pill back onto the card to re-enable a field.

Saving

The field layout is stored as part of the Finder’s configuration. Like all Finder Builder changes, it is not live until you click Save. After saving, the updated layout propagates to the CDN within approximately five minutes. See Caching.

Where to next

• Define or manage the fields themselves: Tags and Custom Fields
• Configure what visitors can filter by: Refinements
• Embed the finished finder: Embedding guide