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
Beta
Intelligent Search Beta
Regionalization (Beta)
Regionalization (Beta)

This feature is in beta, which means that we are working to improve it. If you have any questions, please contact our Support.

Regionalization is a feature of VTEX Intelligent Search that allows for the optimization of search results according to the availability of sellers in the customer's region. To install and configure VTEX Intelligent Search in your store, read our article about Search.

Regionalization uses a behavior from VTEX Intelligent Search called Availability. It searches for products available in the inventory of sellers that serve a particular region.

Stores that have more than one registered white label seller usually have specific inventories for each region. This is the case for supermarkets, for example.

With the Regionalization feature enabled, if a customer enters their ZIP code while browsing the store (before checkout), only products available in the corresponding region will be displayed in the search results.

To start using the Regionalization feature, you must follow the steps described in this article.

  1. Seller configuration
  2. Request to activate the Regionalization feature
  3. Configuration in VTEX IO

While regionalized stores display only products available in a certain region on the product list page, filters do not take regionalization into account. This means that store customers may select filter values that result in products not being available in their region.

1. Seller configuration

First, you must understand which seller scenario applies to your store. See below for possible scenarios.

Seller 1

By default, the architecture of all VTEX stores allows them to operate as both seller and marketplace simultaneously. This means that your VTEX store will be the seller with ID number 1, as it can operate as a seller in its own environment.

This seller is automatically created in the store account, and it represents your own inventory. This applies both to marketplaces that sell their own products and to stores that are not marketplaces, but combine checkout and fulfillment in their ecommerce.

White label seller

A white label seller is a type of seller that the end customers do not choose or acknowledge at any point in the purchase process.

When the consumer adds a product to the cart and simulates shipping, the system automatically selects the white label seller that has that product in stock and displays the delivery methods of the sellers that offer the best conditions. To learn more about the white label seller selection algorithm, please refer to this article.

VTEX Intelligent Search checks the availability of products in the inventory of white label sellers in each region to determine which products will be displayed to the customer, which means you must configure at least one white label seller in your store.

Comprehensive seller

A comprehensive seller is a type of seller that makes items available to customers who do not use location-defined navigation. This configuration prevents products from being displayed to customers who are outside the seller's coverage area. To this end, the comprehensive sellers must have a delivery area that is significant to your store operation.

2. Request to activate the Regionalization feature

The second step in configuring the Regionalization feature is to request the VTEX team to enable it in your store. To do this, please contact our Support team.

3. Configuration in VTEX IO

To learn about the seller configuration requirements necessary to enable Regionalization, please refer to our Regionalization guide.

After configuration, your store will be ready to use the Regionalization feature. Now, when a customer informs their region while browsing, the search results will be displayed considering this information.

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