Skip to main content

How to Change Widget Text, Labels, and Language

Customize every piece of text on your store locator, from the search bar to button labels, or translate the entire widget into another language.

Updated yesterday

Every piece of text on your store locator can be changed. Want to rename "Filters" to "Brands"? Change "Get Directions" to "Cómo llegar"? Hide the "Open/Closed" label entirely? All of this happens in one place.

Where to change widget text

Go to your Languages page. You'll see every text string that appears on your widget, organized by section.

Click into a language (or create a new one) to see all the editable fields. Change any text you want and click Save.

That's it. Changes show up on your live widget within a minute.

Common text changes

Here are the most popular things people customize:

What you want to change

Field name in Languages

Search bar placeholder ("Enter your address...")

Search Placeholder

The "Filters" dropdown label

Filters Label

"Get Directions" button

Directions Text

"Open" / "Closed" status

Open Text / Closed Text

"View Website" link

Website Text

Distance units label

Miles Text / Kilometers Text

"Show All Locations" button

Show All Text

"No results found" message

No Results Text

Loading text

Loading Text

How to hide text or labels

Want to hide something completely? Just leave the field blank and save. If a text field is empty, that element won't show on the widget.

For example, to hide the "Open/Closed" status labels, go to Languages, find Open Text and Closed Text, clear both fields, and save.

Changing CTA button text

Call-to-action (CTA) buttons are a bit different. Their text is set per button, not in the Languages page.

Go to your Buttons page, click on a button, and change its label there. If you need different CTA text per location, you can set that when editing individual locations.

Setting up a different language

If your website is in French, German, Spanish, or any other language, you can translate the entire widget:

  1. Go to your Languages page

  2. Click Create Language

  3. Name it (e.g., "French", "Deutsch", "Español")

  4. Translate every field into your language

  5. Save

Then, tell StoreRocket to use this language by adding data-storerocket-lang to your embed code:

data-storerocket-lang="French"

The value must match the exact name you gave your language in step 3.

Running a multilingual widget

If your website supports multiple languages (like English and French), you can show the right language automatically.

Option 1: Separate embed codes per language page

If your English site is at example.com/en/stores and French at example.com/fr/stores, use a different data-storerocket-lang attribute on each page:

English page: data-storerocket-lang="English" French page: data-storerocket-lang="French"

Option 2: Dynamic language switching

If you use a language switcher that changes the page language, you can pass the language to StoreRocket dynamically through the embed code. The widget will reload with the correct translations.

Address format customization

The way addresses display on your widget depends on how your location data is stored. If you want to change the order of city, state, and postcode, or hide certain address parts, go to your Widget Components settings and adjust which address fields are visible and in what order.

Troubleshooting

Changes not showing on live site

Give it a minute. If your browser cached the old version, try a hard refresh (Ctrl+Shift+R on Windows, Cmd+Shift+R on Mac). If you're using a CDN or caching plugin on your website, clear that cache too.

Language not applying

Check that the data-storerocket-lang value in your embed code matches the exact name of your language in StoreRocket. It's case-sensitive, so "French" and "french" are different.

Some text still in English after translating

Make sure you translated ALL the fields, not just the obvious ones. Scroll through the entire Languages form to catch any you missed. Some fields only appear in specific situations (like error messages or mobile-only text).

CTA button text not changing

Remember, CTA buttons are edited on the Buttons page, not in Languages. Each button has its own text field.

Questions about text customization? Hit us up on live chat.

Did this answer your question?