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 per binding
Managing URL redirects per binding

Redirects are a tool to forward both users and search engines to a more relevant or similar live URL different from those they initially requested.

Multi-domain stores commonly ask for redirect management per binding due to the complexity presented by the several URLs available simultaneously.

Taking this into consideration, VTEX enables you to manage your URL redirects according to the store bindings through the admin interface.

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.

In VTEX Admin:

  1. Access Storefront > Pages.
  2. Click on the Redirects tab.

{"base64":"  ","img":{"width":2064,"height":1430,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":275953,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Pages/managing-redirects-per-binding_1.png"}}

Manually creating redirects

  1. Click on the New Redirect button.
  2. In the Binding field, use the dropdown menu to select the desired binding.
  3. Use the From and To fields to define the former URL and the new one to which users and search engines will be redirected.
  4. Check whether your redirect will be permanent or temporary — in case it is temporary, you can toggle the This redirect has an end date button to set an end date for it.
  5. Save your changes.

{"base64":"  ","img":{"width":1910,"height":1256,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":108268,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Pages/managing-redirects-per-binding_2.png"}}

Manually deleting redirects

  1. Click on the desired redirect to be deleted.
  2. Click on the Remove button.
  3. Confirm your action.

{"base64":"  ","img":{"width":1902,"height":1246,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":126287,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Pages/managing-redirects-per-binding_3.png"}}

A bug may be found when trying to click on redirects with query strings. The VTEX product team is already aware of this unexpected behavior and working on the fix. If you cannot click on the desired redirect to delete it, opt to do it through the spreadsheet while the issue is not resolved.

Importing and exporting redirects

To manage your store's redirects in bulk, you can import and export a redirect spreadsheet.

The spreadsheet's inputs will be mandatorily created or deleted from the store's redirect list — it is not possible to create and delete redirects using the same spreadsheet. Before filling out and uploading yours to the admin, keep in mind your final goal with it.

  1. Click on the Import button and then on Download Template. Click on the Export button if you aim to download and modify the pre-saved redirect list.
  2. Open the spreadsheet template once the download is done and fill out the cells in the suitable columns according to the table below:
ColumnExpected value
fromFormer URL no longer useful to users and search engines.
toNew URL to which users and search engines will be redirected to.
typeWhether the redirect will be permanent or temporary, i.e., have an end date.
bindingBinding to which the redirect will be applied. Caution: this column's cells must be filled out with the desired binding IDs.
endDateEnd date for the redirect following the UTC format. Notice that this column's cells should only be filled out when the redirect type is set as temporary.
  1. Save your spreadsheet once satisfied with the changes performed.
  2. Click on the Import button.
  3. Check the Save or the Delete button according to your scenario.

{"base64":"  ","img":{"width":2280,"height":1472,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":191078,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Storefront/Pages/managing-redirects-per-binding_4.png"}}

By clicking on the Save button, you will create all the redirects listed in your spreadsheet, whereas clicking on the Delete button will remove all of them from your store's redirect database.

  1. Upload the spreadsheet from your local files.
  2. Click on the Import file button.
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