To configure a redirect, follow the steps below.
- In the VTEX Admin, go to Storefront, or type Storefront in the search bar at the top of the page.
- In Intelligent Search, click Redirects.
- Click the
New
. - Fill in the general information fields detailed in the section below.
- Click
Add condition
. - Fill in the Trigger rules fields.
- To finish, click
Apply
.
You must fill in the fields below.

General information
This section provides the following general information:
- Name: name of the rule set for the redirect you created.
- Redirect URL: URL to which the client will be forwarded. You must enter the full URL. Example:
https://www.store.com/_secure/account/#/orders
instead of_secure/account/#/orders
. - Locales: Languages to which the redirect will apply. The field is only available for stores using Multilanguage settings (Beta).
Trigger rules
Trigger rules are a set of conditions related to terms or filters that will be applied to each search performed. At least one condition must be configured, either by term or by filter.
Select the type of rule, either by term or by filter.
- Term: word searched by the customer that will be related to the rule. You can choose between two options:
is
: the search must be an exact word search. Example: if you enter "Black Friday" and the customer searches for "Black Friday", the redirect will be triggered. If they search for "Black Friday promotion", the redirect will not be triggered.contains
: the search does not have to be an exact word search. Example: if you enter "Black Friday" and the customer searches for "Black Friday", the redirect will be triggered. If the customer searches for "Black Friday promotion", it will also be activated.
- Filter: searchable attribute already defined that restricts the search results. Selecting a registered filter enables the redirection created. Customers can choose from two filter options:
is
: this option allows the customer to select not only the filter for the rule. Example: if the rule isis
: Filter brand, value Nike. The redirect is triggered even if the customer also selects adidas.only
: this option allows only the configured filter to be selected. Example: if the rule isonly
: Filter brand, value Nike. If the customer selects adidas, the redirect will not be triggered. It will only work if the first brand filter is Nike.
If you want to create more than one rule, you must add an interaction between the rules. They can be:
or
: any of the registered rules enable the redirection.and
: to enable the redirection, all rules must be met.
By clicking on , you will see the following options:
- Duplicate: creates a copy of the selected rule.
- Delete: deletes the selected rule.
To clear all configured rules, click Clear rules
.
Importing CSV files
If you need to add several redirects, you can create a CSV file and import it into the Admin. The file must follow this format for each redirect created: <Name>;<URL>;<Type>;<Active>;<Topic>;<Verb>;<Value>
.
- Name: the title of the redirect. The possible values are
term
orfilter
. - URL: the redirect URL.
- Type: trigger rule. The possible values are
and
oror
. - Active: redirect activation condition. The possible values are
true
orfalse
. - Topic: searchable attribute. Possible values are
term
for term redirection orbrand
,category
,department
,sellername
andsubcategory
for filter redirection. - Verb: option to include the Topic. The possible values are
is
orcontains
. - Value: value of the term or filter.
To import the file, follow the instructions below.
- In the VTEX Admin, go to Storefront, or type Storefront in the search bar at the top of the page.
- In Intelligent Search, click Redirects.
- Click
Import From CSV
.