Map Field

The map field stores structured location-oriented data.

Best For

• office locations
• address blocks
• map-driven contact sections
• structured place information

Schema Example

{ "name": "officeLocation", "label": "Office Location", "type": "map" }

Template Usage

<div class="office-location">
  {{ officeLocation.address }}
</div>

Map render example:

<div class="location-map">
  {officeLocation.size(800,500)}
</div>

Use It When

Use map when the content is truly place-oriented and should remain structured as location data.

Do Not Use It When

Do not use map for:

• plain text addresses with no structured location need
• generic contact details

Use textarea or text if the content is just simple copy.

Runtime Behavior

The map field is designed for structured location data and runtime map rendering.

Typical usage patterns include:

• {officeLocation} for default map output
• {officeLocation.width(600)} for width-constrained output
• {officeLocation.height(400)} for height-constrained output
• {officeLocation.size(800,500)} for explicit dimensions

This makes map different from plain text address fields. The value is not just copy. It is a structured location input that can render an interactive map container.

Technical Notes

• use map when the section needs real location behavior, not just an address string
• keep nearby text fields for labels, directions, or office names instead of forcing prose into the map field
• use method-style sizing when the design needs controlled map dimensions
• if the page only needs one plain address line, use text or textarea instead

Related

• Text
• Textarea
• Facet Template Syntax