Managing StoresUpdated 2026-08-25

Add custom fields

What this article helps you do

Add custom fields, such as “Parking details” or “Book an appointment.” Show them in the list, marker popup, or the two positions.

Before you start

  • Mapstore is configured with one or more stores.
  • You can have a maximum of 5 custom fields for each shop.

Step-by-step instructions

1. Define custom fields

  1. In Mapstore, go to Custom fields from the primary navigation.
  2. Click Add custom field.
  3. Enter a Field name, such as “Parking” or “Wi-Fi”.
  4. Select the Field type: Text (plain text) or Link (URL).
  5. Select Visibility position: List view, Popup, or the two positions.
  6. Click Create field.
  7. Do these steps again for more fields. You can create a maximum of 5 fields.

2. Add values to stores

  1. Go to Stores.
  2. Open a store or create a store.
  3. Go to the Custom fields section.
  4. Enter the values for each custom field that you defined.
  5. Save the store.

3. Include custom fields in CSV or Google Sheets (optional)

If you import from CSV or Google Sheets, use custom field headers in this format:

  • cf_text_FieldName for text fields
  • cf_link_FieldName for link fields

Examples:

  • cf_text_Parking
  • cf_link_Booking_URL

You can also control where a field shows:

  • cf_text_l_FieldName (list only)
  • cf_text_p_FieldName (popup only)
  • cf_text_lp_FieldName (list and popup)

How to verify it worked

  1. View your store locator on the storefront.
  2. Check the list view and the store popup.
  3. Make sure that you can see each field in its selected position.
  4. Change a custom field value.
  5. Save the store.
  6. Make sure that you can see the new value on the storefront.

Troubleshooting

Issue Fix
“Define more” or “Add custom field” is missing You have 5 custom fields. Remove or edit an existing field before you add a new field.
Custom field is not on storefront Select List view, Popup, or the two positions. Make sure that you saved a value for the store.
“This name conflicts with an existing CSV header key” Select a field name that is not a built-in column. Do not use “name”, “address”, or “phone”.
Column from CSV not mapped to custom field Use the cf_text_FieldName or cf_link_FieldName format. Mapstore does not map plain column names to custom fields.