> For the complete documentation index, see [llms.txt](https://sl-guide.storeify.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sl-guide.storeify.app/custom-fields.md).

# Custom Fields

Add your own details to every location, such as the store manager, parking, a “VIP dealer” badge or a booking link, and choose exactly where customers see them.

Custom fields work alongside the standard details (address, phone, email, website, tags, social links). You set them up once, fill in the values per location, then place them among the standard details for each part of your store locator:

* **Store list:** The results list next to the map
* **Map popup:** The info window when a pin is clicked
* **Store detail page:** The “Store information” block

You can create up to **10 custom fields**.

{% embed url="<https://youtu.be/rSy13bA-bvA>" %}

## Step 1

### Create a custom field

1. In the app, go to Settings and scroll to Store information visibility.
2. Click Manage custom fields under the list.
3. In Add a custom field, enter a **Label**. This is what customers see next to the value, for example “Parking”.
4. Pick a **Type** (see the table below) and click Save field.

<figure><img src="https://3a19ae14-92b4-4cec-8ad6-691eb3be5224.frame.claudeusercontent.com/_f/1790755263-8791/img/admin-custom-fields.png" alt="Custom fields page listing VIP Dealer, Manager, Parking, Booking and an inactive Holiday hours field, with Edit, Deactivate and Delete buttons, and the Add a custom field form below"><figcaption><p>The Custom fields page. Each row shows the type, the field’s key (used for import/export) and where it currently appears.</p></figcaption></figure>

#### Field types

| Type             | Use it for                                                               | How customers see it                                                                                                                                                                                            |
| ---------------- | ------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Single line text | Manager name, opening note, short facts                                  | Label: value                                                                                                                                                                                                    |
| Multi-line text  | Longer descriptions, lists, formatted content, a booking button or embed | Label, then the text with line breaks kept. HTML is displayed as formatted content (see [HTML in multi-line fields](https://sl-guide.storeify.app/google-map-api-key/custom-fields#html-in-multi-line-fields)). |
| Link (URL)       | Booking page, menu, catalogue                                            | A clickable link. Links to another website open in a new tab; links to your own store open in the same tab.                                                                                                     |
| Email            | A department or manager’s email                                          | A clickable email address                                                                                                                                                                                       |
| Phone            | A second phone line, WhatsApp number                                     | A tap-to-call number                                                                                                                                                                                            |
| Yes / No         | Badges such as “VIP Dealer”, “Wheelchair access”                         | A check mark and the label, shown only when set to *Yes*                                                                                                                                                        |

Where does a new field appear? A new field is added to the store list and the store detail page straight away (at the end of the list, and after Website on the detail page). It stays hidden in the map popup until you switch it on. You can change all of this in [Step 3](https://sl-guide.storeify.app/google-map-api-key/custom-fields#step-3).

### Edit, deactivate, reorder or delete a field

Every row on the Custom fields page has its own buttons. Changes are saved immediately, with no need to click a Save button, and your storefront is updated automatically.

automatically.

| Action        | What it does                                                                                                                                                                                                 |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Edit          | Loads the field into the form at the bottom of the page so you can rename it or change its type. Click Save field to apply, or Cancel.                                                                       |
| Deactivate    | Hides the field everywhere on your storefront without losing anything. The row turns grey and shows an *Inactive* badge. Click Activate to bring it back.                                                    |
| Drag handle ⠿ | Changes the order of the fields on the location add/edit form. To change the order customers see, use [Store information visibility](https://sl-guide.storeify.app/google-map-api-key/custom-fields#step-3). |
| Delete        | Removes the field after you confirm. It stops showing on your store locator right away.                                                                                                                      |

<figure><img src="https://3a19ae14-92b4-4cec-8ad6-691eb3be5224.frame.claudeusercontent.com/_f/1790755263-8791/img/admin-custom-fields-edit.png" alt="After clicking Edit on VIP Dealer, the form at the bottom is titled Edit custom field and shows its label and type"><figcaption><p>Clicking <strong>Edit</strong> fills the form at the bottom of the page.</p></figcaption></figure>

<figure><img src="https://3a19ae14-92b4-4cec-8ad6-691eb3be5224.frame.claudeusercontent.com/_f/1790755263-8791/img/admin-custom-fields-delete.png" alt="Delete custom field confirmation dialog saying Manager will stop showing on your store locator and values already entered are kept"><figcaption><p>Deleting always asks for confirmation.</p></figcaption></figure>

{% hint style="info" %} <mark style="color:$primary;">**Values are kept.**</mark> Deactivating or deleting a field never erases what you typed on your locations. If you delete a field by mistake, create it again with the same label and the values come back.
{% endhint %}

{% hint style="info" %} <mark style="color:$warning;">**The key doesn’t change.**</mark> A field’s key (for example `cf_vip_dealer`) is set when you create it and stays the same if you rename the label later. Your import/export files keep working.
{% endhint %}

## Step 2

### Fill in values on each location

1. Open Locations and edit a location (or add a new one).
2. Scroll to the Custom fields section. There is one input per field, in the order set on the Custom fields page.
3. Enter the values and click Save in the save bar at the top.

<figure><img src="https://3a19ae14-92b4-4cec-8ad6-691eb3be5224.frame.claudeusercontent.com/_f/1790755263-8791/img/admin-location-inputs.png" alt="Custom fields section of a location form: VIP Dealer and Parking checkboxes ticked, Manager set to Duke, Booking containing an HTML link, and an empty Holiday hours field marked inactive"><figcaption><p>Yes / No fields are checkboxes. Inactive fields can still be filled in, so you can prepare values before switching a field on.</p></figcaption></figure>

* **Leave a field empty** to hide it for that location. Nothing is shown, not even the label.
* Text fields hold up to 1,000 characters; multi-line text holds up to 5,000.

#### HTML in multi-line fields

Multi-line text fields accept HTML, which your storefront shows as formatted content instead of code. For example:

`<a href="https://example.com/book">Book a visit</a>`

* **Allowed:** text formatting (bold, italic, headings, paragraphs), lists, links, images, tables, buttons, and `iframe` embeds that use `https://`. Inline `style` attributes are supported.
* **Removed for security:** scripts, forms and inputs, `<style>` blocks, event handlers such as `onclick`, and `javascript:` links.
* Plain text is fine too: line breaks are kept, and text like “Price < 10” is shown as written.

## Step 3

### Choose where each field shows, and in what order

Go to Settings › Store information visibility. There is one panel for each place details appear. Each collapsed panel summarises how many details are shown there, in display order. Click a panel to open it; the others close.

<figure><img src="https://3a19ae14-92b4-4cec-8ad6-691eb3be5224.frame.claudeusercontent.com/_f/1790755263-8791/img/admin-settings-collapsed.png" alt="Store information visibility with three collapsed panels: Store list 10 of 12 shown, Map popup 12 of 13 shown, Store detail page 12 of 12 shown"><figcaption><p>Collapsed panels show a summary, for example “10 of 12 shown · Address, VIP Dealer, Phone, Email +6 more”.</p></figcaption></figure>

1. **Tick or untick** a detail to show or hide it in that place. Custom fields are marked with a *Custom* badge.
2. **Drag the handle ⠿** to move a detail up or down. Custom fields can go anywhere between the standard ones, for example “VIP Dealer” right after the address.
3. Each place has its own order, so the map popup can differ from the store list.
4. Click Save in the save bar. Click Discard instead to undo all changes since the last save.

<figure><img src="https://3a19ae14-92b4-4cec-8ad6-691eb3be5224.frame.claudeusercontent.com/_f/1790755263-8791/img/admin-settings-visibility-map.png" alt="Map popup panel expanded, listing Address, VIP Dealer (Custom), Phone, Email, Website, Tags, Contact us, Manager, Parking, Booking, Social network, an unticked inactive Holiday hours, and Schedule pinned at the bottom"><figcaption><p>The Map popup panel. <em>Schedule</em> is always shown at the bottom of the popup and can’t be moved. Inactive fields show an <em>Inactive</em> badge and stay hidden until activated.</p></figcaption></figure>

## Step 4

### Check your storefront

After saving, open your store locator page. Here is one location with four custom fields (VIP Dealer, Manager, Parking, Booking) in each place:

<figure><img src="https://3a19ae14-92b4-4cec-8ad6-691eb3be5224.frame.claudeusercontent.com/_f/1790755263-8791/img/store-list-item.png" alt="Store list entry for Store 01 showing a VIP Dealer check mark after the address, and Manager: Duke and Parking: Yes after Contact store" width="563"><figcaption><p><strong>Store list.</strong> “VIP Dealer” sits right after the address; Manager and Parking follow the standard details.</p></figcaption></figure>

<figure><img src="https://3a19ae14-92b4-4cec-8ad6-691eb3be5224.frame.claudeusercontent.com/_f/1790755263-8791/img/map-popup.png" alt="Map popup for Store 01 with VIP Dealer after the address and Manager, Parking and a Booking button before the social icons" width="563"><figcaption><p><strong>Map popup.</strong> Its own order, including the Booking field rendered from HTML as a button.</p></figcaption></figure>

<figure><img src="https://3a19ae14-92b4-4cec-8ad6-691eb3be5224.frame.claudeusercontent.com/_f/1790755263-8791/img/detail-info.png" alt="Store Information block on the store detail page with VIP Dealer, Manager, Parking and Booking between the website and the tags" width="563"><figcaption><p><strong>Store detail page.</strong> Custom fields placed between Website and Tags.</p></figcaption></figure>

{% hint style="info" %} <mark style="color:$primary;">**Not seeing your change?**</mark> Your storefront is updated right after you save, but your browser may still show a cached copy. Reload with **Ctrl+Shift+R** (Windows) or **Cmd+Shift+R** (Mac), or open the page in a private window.
{% endhint %}

### Import and export

Custom fields are included when you import and export locations, with one column per field. The column name is the field key shown on the Custom fields page, for example `cf_manager` or `cf_vip_dealer`.

* **Export** adds a `cf_…` column for each field. Exporting first is the easiest way to get a file with the right headings.
* **Import:** if a `cf_…` column is missing from the file, that field is left unchanged. If the column is there but a cell is empty, that location’s value is cleared.
* **Yes / No columns** accept `1`, `yes`, `true`, `on` or `y` for Yes. Anything else, including empty, means No.

## Troubleshooting

<details>

<summary>A custom field doesn’t show on my storefront</summary>

Check these in order:

* The field is **active** on the Custom fields page (no *Inactive* badge).
* It is **ticked** in the right panel of Store information visibility. New fields start hidden in the map popup.
* The location has a **value** for it. Empty fields are hidden, and Yes / No fields only show when set to Yes.
* You clicked **Save** in Settings, then reloaded your storefront without the cache (Ctrl/Cmd+Shift+R).

</details>

<details>

<summary>My HTML shows as code, or part of it disappears</summary>

HTML is only rendered in **Multi-line text** fields. Single line text always shows exactly what you type. Parts that could run code are removed: scripts, forms, event handlers such as `onclick`, and embeds that don’t use `https://`. If everything in the value was removed, the field is hidden for that location.

</details>

<details>

<summary>The order in the map popup is different from the store list</summary>

That is expected: the store list, map popup and store detail page each have their own order. Open each panel in Store information visibility and arrange it the way you want.

</details>

<details>

<summary>I can’t add another field</summary>

You’ve reached the limit of 10 custom fields. You can still edit, deactivate or delete existing ones, and deleting one frees up a slot.

</details>

<details>

<summary>I deleted a field by mistake</summary>

Create it again with the **same label**. It gets the same key, and the values saved on your locations appear again. Then place it again in Store information visibility.

</details>