Skip to main content

How to Customize Your Location Pop-Up

Customize your location pop-up.

Written by Treez Support

How to Customize Your Location Pop-Up

You can now update the headers, button text, and links in your location modal using the new Store Locator document in Prismic. Follow the steps below to get started.

Step 1: Add the Store Locator Page in Prismic

  1. Log in to Prismic and open your content management repository.

  2. Create a new page by clicking the "+ Create a new page" button in the top-right corner.

  3. Search for "Store Selector" in the document types and select the Store Selector template.

Step 2: Customize the Store Locator Page

Once your page is created, you'll be able to configure the following elements:

Pop-Up Titles

  • Button Title - Title of the Store Selection Button - Currently, "How Do You Want to Shop?" Text exceeding 25 characters will be truncated with '...'.

  • Title – Displayed at the top of the modal. Example: "Select Pickup or Delivery"

  • Pickup Section Title – Text shown after a user selects Pickup. Example: "Select Pickup Location"

  • Delivery Section Title – Text shown after a user selects Delivery. Example: "Enter Your Delivery Address"

Main Action Button

  • Main Button Type – Choose the button style:

    • Primary (main theme color)

    • Secondary

    • Tertiary

  • Pickup Main Button Text – Example: "Shop Pickup"

  • Delivery Main Button Text – Example: "Shop Delivery"

Secondary Button (Optional)

  • Secondary Button Text – Example: "View Map"

  • Secondary Button Link – Define the page to link to. Example: "store-locator"

  • Hide Secondary Button – Set to True to hide this button.

  • Hide Icon on Secondary Button – Set to True to hide the map pin icon.

Need a visual?

The image below shows how each field in Prismic maps directly to elements in the Location Pop-Up on your ecommerce site, making it easy to see where your customizations will appear.

State/Region Filter Tabs (New! 04.27.26)

The Store Selector now supports horizontal filter tabs on the pickup store list. This lets you organize stores by state or region, making it easier for customers to find their nearest location — especially useful for multi-state operators.

Filter tabs (state / region)

A toggle that turns the tab filter feature on or off.

  • On — Shows horizontal filter tabs above the pickup store list

  • Off — Displays a flat store list with no tabs (default behavior)

"All" tab label

The label for the first tab, which shows all stores regardless of state. Defaults to All if left blank. Customize it to match your brand voice (e.g., "All Locations", "Everywhere").

Tab filters

A repeatable group where you define each tab. Add as many tabs as you need — one per state or region. Each tab has two fields:

  • Tab label — The name displayed on the tab (e.g., California, Michigan, Pacific Northwest)

  • State codes (comma-separated) — The two-letter state code(s) that map to that tab. Use a single code for one state (CA) or multiple codes for a regional grouping (CA, NV, OR)

How to Set Up Filter Tabs

  1. Open your Store Selector document in Prismic

  2. Toggle Filter tabs (state / region) to On

  3. Optionally update the "All" tab label (leave blank to default to "All")

  4. Click + Add item in "Tab filters" to add your first tab

  5. Enter a Tab label (e.g., California) and the corresponding State codes (e.g., CA)

  6. Repeat for each state or region you want to display

  7. Use the arrow buttons to reorder tabs, or the trash icon to remove one

  8. Save and publish

Tips

  • Tabs appear in the order you add them — put your highest-traffic state first

  • You can group multiple states under one tab (e.g., label: West Coast, codes: CA, OR, WA)

  • If a store's state doesn't match any tab filter, it won't appear under that tab — make sure all active states are covered

  • The All tab always shows every store regardless of state assignment

Did this answer your question?