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
Pages
Managing URL redirects
Managing URL redirects

Redirects is a feature that redirects the customer to any other internal or external page. It is done in the search area using selected terms or filters.

To create, edit, or remove redirects, the Admin user must have a role that has the License Manager CMS Settings resource. You can grant the user a role with the resource by following the instructions in the How to manage users article or create a new role including the resource by following the instructions in the Roles article.

Multiple redirects are possible in a single URL. To create a redirect, follow the instructions below.

  1. In the VTEX Admin, click Storefront > Redirects.
  2. Click New Redirect.
  3. Fill in the following fields: From: Enter the page URL from which you want to redirect visitors. The URL should not contain the domain name, for example: /mask-regenerator-marine-algae/p. To: Enter the page URL to which you want visitors to be redirected. The URL must not contain the domain name, for example: /conditioner-ultra-hydrating-milk conditioner/p.
  4. In the checkbox, indicate whether this redirect is temporary or permanent. If it is temporary, you need to set an end date.
  5. Click Save.

{"base64":"  ","img":{"width":761,"height":536,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":16424,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Pages/managing-url-redirects_1.png"}}

Importing redirects

Follow the steps below to import a redirect.

  1. Click Import.
  2. Choose a CSV file from your computer, making sure that the separator is a semicolon (;).
  3. Click Import File.
  4. Click Save.

Please note that some editors can automatically change the separator. Therefore, before importing a file, make sure that it is correctly formatted as CSV and that it uses a semicolon (;) as the value separator. Files containing other separators, such as comma (,) or tab (  ), are not supported.

Some editors, such as Google Sheets, export CSV files using a comma (,) as the default separator and may not accept semicolons (;). In these cases, we recommend using other editors that allow you to replace separators or save the file using semicolons (;) as separators.

Exporting redirects

If you want to export your redirects, click Export, and they will be downloaded to your computer.

You cannot create redirects via predefined routes like "home", "/", "login", "account", etc. We recommend creating them manually by following the instructions mentioned above.

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