Menu
Feedback
Start here
Tutorials & Solutions
Developers Portal

Known Issues
Support Rules

Frequently Asked Questions
Announcements
Start here
VTEX IO
VTEX Intelligent SearchConfiguring Redirects
Configuring Redirects
3 min read

To configure a redirect, follow the steps below.

  1. In the VTEX Admin, go to Storefront, or type Storefront in the search bar at the top of the page.
  2. In Intelligent Search, click Redirects.
  3. Click the New.
  4. Fill in the general information fields detailed in the section below.
  5. Click Add condition.
  6. Fill in the Trigger rules fields.
  7. To finish, click Apply.

You must fill in the fields below.

{"base64":"  ","img":{"width":770,"height":578,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":36709,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tracks/vtex-intelligent-search/configuring-redirect_1.png"}}

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 is is: 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 is only: 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 or filter.
  • URL: the redirect URL.
  • Type: trigger rule. The possible values are and or or.
  • Active: redirect activation condition. The possible values are true or false.
  • Topic: searchable attribute. Possible values are term for term redirection or brand, category, department, sellername and subcategory for filter redirection.
  • Verb: option to include the Topic. The possible values are is or contains.
  • Value: value of the term or filter.

To import the file, follow the instructions below.

  1. In the VTEX Admin, go to Storefront, or type Storefront in the search bar at the top of the page.
  2. In Intelligent Search, click Redirects.
  3. Click Import From CSV.
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest edits (Github)
Redirects
« Previous
Search configuration
Next »
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
GithubDevelopers PortalCommunityFeedbackSite Map