Menu
Feedback
Start here
Tutorials
Developer portal

Known Issues
Support Rules
Troubleshooting

Frequently Asked Questions
Announcements
Tutorials
Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
Storefront
Layout
Changing default system texts displayed in the store
Changing default system texts displayed in the store

VTEX system renders a series of standard texts in the store.

For each of these texts, there is a key that identifies it (a kind of variable name) and the corresponding text (the contents of that variable).

For example, in the site topbar - which by default is part of the header subtemplate -, the welcome message is displayed. This message is identified by the topbarSaudacao key and initially comes with the text "Welcome!".

For each key used by the system, you can change the corresponding text. To do this, follow the steps below:

  1. In the VTEX Admin, access Store Settings > Storefront > Settings.
  2. Use the selection box to find the key you want to change.
  3. Change the text that appears in the field below the selection box.

Variables

Some special variables are available to compose more complex texts:

  • Definite article
  • Preposition
  • Locative preposition
  • Possessive pronoun
  • Store Name
  • Site URL in texts

For example, you want to display the following welcome message in the topbar of the store: Welcome to the World Shopping.

In this case, the terms to and World Shopping are special. The first is a proposition, which varies according to the name of each store, and the second is the name of the store, which obviously also varies.

To do this dynamically, I can change the text of the topbarSaudacao key to the following:

Welcome @preposicaonomeloja2@ @nomeloja@.

That is, I'm using the variables preposicaonomeloja2 and nomeloja.

When using variables to compose a text, replace the # symbol with @. That is, #variable# becomes @variable@.

{"base64":"  ","img":{"width":2260,"height":170,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":30893,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Store%20Settings%20-%20Storefront/changing-default-system-texts-displayed-in-the-store_1.png"}}
{"base64":"  ","img":{"width":777,"height":666,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":42157,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Store%20Settings%20-%20Storefront/changing-default-system-texts-displayed-in-the-store_2.png"}}

As I defined the content of the first variable to be "to" and the second one is "World Shopping", the final text rendered on the site will be "Welcome to World Shopping".

To easily change the special variables that appear in the Important Texts section, simply click on them.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback