Marketplaces need to review and approve offers submitted by sellers to add products to the catalog. In the VTEX Admin, this cataloging process is done through the Received SKUs page.
Quality criteria are important for the marketplace's operation so that the offers submitted to the page meet the requirements relevant to the curation of your catalog.
Offer quality filters is the page where marketplaces add and manage the requirement groups applied to the received SKU cataloging process. To access it, in your VTEX Admin, go to Marketplace > Offer Quality or type "Offer Quality" in the search bar.

In this article, learn how to:
- View Default Rules.
- Create requirement groups.
- Activate and deactivate requirement groups.
- Edit and delete requirement groups.
- Move mandatory and optional requirements.
- Catalog offers with requirements.
Advantages of using this feature
Once the requirements are created, the offers submitted by sellers that do not meet the criteria are automatically rejected and separated from the others so that the marketplace can identify them and ask the sellers to correct them. Thus, the number of offers the marketplace's catalog team must review decreases, increasing the curation process's efficiency. Learn more in the Cataloging offers with requirements section.
The feature allows the marketplace operator to perform many actions, each offering a different advantage for their business, as described in the following table.
Feature action | Advantage |
---|---|
Create requirements to filter offers submitted on the Received SKUs page. | Scales up the seller and product onboarding, boosting time-to-revenue in the marketplace channel. |
Define to which sellers, categories, or brands the rules will apply and exception cases. | It refines the criteria used for the rejection and approval process of offers. |
View which offers have been rejected for not meeting the mandatory and/or optional requirements, moving them to the "Pending", "Review", and "Rejected" tabs based on the requirements met. | It enables the marketplace catalog team to review each offer individually to see why it did not meet the requirements. |
Bring more transparency to the cataloging criteria for submitted offers and how sellers and offers do or do not comply. | It allows you to identify which sellers and offer types do not meet the requirements, speeding up corrections. |
Viewing Default requirements

The page, by default, has some pre-configured requirements that will apply to all categories, sellers, and brands, called Default requirements. Some of these criteria are natively configured in VTEX Matcher, the tool applied to VTEX marketplaces to support the cataloging process of submitted offers.
You cannot disable the Default requirements. They are visible on the Offer quality filters page to show you which rules already applies to all submitted offers.
To view the rules that are already active by default, on the Offer quality filters page, select the Default requirements
requirement group and see the options:
- Has a maximum number of character limit of 150.
- Up to 50 images.
- Ref ID has a maximum character limit of 50.
- EAN has a maximum character limit of 50.
You can configure VTEX Matcher's auto-approval of offers via Save Account's Approval Settings REST API calls. These are different criteria than the ones available on the Offer Quality filters page and apply to the automatic approval of offers from specific sellers.
Creating requirement groups
Create requirement groups to set rules that apply to sellers, categories, or marketplaces. Requirement groups apply rules to the fields listed below. Learn more about each Requirement type.
- Price
- Quantity in stock
- Number of images
- Description
- Title
- EAN
- Ref ID
- Seller brand
- Brand
- Category
- Seller category
- SKU specification
- Product specification
You can create mandatory and/or optional requirements. Learn more about the implications of each requirement in Cataloging offers with requirements.
Notice that each requirement group holds only one value. Therefore, you need to create another requirement group to add more than one value. For example, if the marketplace wants to add the words "Shirts" and "T-shirts" as mandatory requirements for the Seller brand field, you need to create a requirement group for "Shirts" and another one for "T-shirts".
Follow the steps below to create a new requirement group:
- In the VTEX Admin, go to Marketplace > Offer Quality.
- Select an option:
- Add mandatory requirements group: The requirements that are essential for an offer to be eligible to be listed in your marketplace's catalog. Learn more about the effects of mandatory requirements in Cataloging offers with requirements.
- Add your first optional requirements group: The requirements that are desirable for an offer to be eligible to be listed in your marketplace catalog. Learn more about the implications of optional requirements in Cataloging offers with requirements.
- Fill in the form fields:
a. Group information
b. Segmentation
c. Add exception cases (optional)
d. Add requirement - After adding requirements, click
Confirm
. - Click
Save
.
You must enable requirement groups if you want them to be applied to received SKUs. Learn more in the Activating and deactivating requirement groups section.
Form fields
Form section | Field | Description |
---|---|---|
Group information | Group name | Add the name that will identify the requirement group for your team. Examples: Requirements for Seller ABC, Image requirements, Filters for Shirts category. |
Segmentation | Categories | Define whether the requirements will apply to one or more categories. |
Brands | Define whether the requirements will apply to one or more seller brands. | |
Sellers | Define whether the requirements will apply to one or more marketplace sellers. | |
Add exception cases | Categories | Define which categories are not affected by this requirement group. |
Brands | Define which brands will not be affected by this requirement group. | |
Sellers | Define which sellers will not be affected by this requirement group. | |
Add requirement | Offer field | Select which field will be affected by the requirement from the options: - Category - Seller category - Description - EAN - Product specification - SKU specification - Brand - Seller brand - Number of images - Price - Quantity in stock - Ref ID - Image size - Title Learn more in the Requirement types section. |
Operation | Select the operation applied to that field, such as "Is", "Is not", "Equal to", "Minimum", or others. See all available options in the Requirements types section. | |
Values | Define the values that will be affected by the operation. Their filling depends on the selected operation. In some operations, the "values" field will allow the insertion of more than one value. See all available options in Requirement types. |
Requirement types
You can create groups of rules for different business applications. Each requirement group has the field, operation, and values that the retailer defines. See below the requirement types and operations available for each.
Price
- At least: The minimum price value required for the received offers.
- At most: The maximum price value required for the received offers.
Quantity in stock
- At least: The minimum stock value required for the received offers.
- At most The maximum stock value required for the received offers.
Number of images
- At least: Defines the minimum number of images required to validate an offer.
- At most: Defines the maximum number of images required to validate an offer.
- Is: Defines the exact number of images required to validate an offer.
Description
- Has the word: Defines a string that must be in the offer description.
- Doesn't have the word: Defines a word that must not be in the offer description.
- Doesn't have the character type: Defines a character that must not be in the offer description.
- Has a maximum number of characters of: Defines the maximum character limit in the offer description.
- Has a minimum number of characters of: Defines the minimum character limit in the offer description.
- Filled: Defines that the description must be filled in.
Title
- Has the word: Defines a word that must be in the offer title. You can add more terms by creating another requirement group.
- Doesn't have the word: Defines a word that must not be in the offer title. You can add more terms by creating another requirement group.
- Doesn't have all characters in: Defines whether all characters in the title should be in uppercase or lowercase.
- Has a maximum number of characters: Defines the maximum character limit in the offer title.
- Has a minimum number of characters: Defines the minimum character limit in the offer title.
- Filled: Defines that the title must be filled in.
EAN
- Filled: Defines that the EAN field must be filled in the offer.
- Has a number of characters equal to: Defines that the EAN must have a specific number of characters.
Ref ID
- Filled: Defines that the Ref ID field must be filled in.
- Has a number of characters equal to: Defines that the Ref ID must have a specific number of characters.
Seller brand
- Is: Defines that the offer brand field must correspond to a specific value.
- Is not: Defines that the offer brand field must not match a value set in the rule.
- Has not: Defines a word that must not be in the offer brand. You can add more terms by creating another requirement group.
- Has: Defines the word that must be in the offer brand. You can add more terms by creating another requirement group.
- Filled: Defines that the brand field must be filled in.
Brand
This field is populated by VTEX Matcher when the brand submitted by the seller has been mapped. This rule allows you to validate that sellers only send previously mapped brands or block a specific brand that has been mapped in the past.
- Is mapped: Defines that the brand submitted by the seller must be mapped in the VTEX Matcher.
- Is: Defines that the offer brand field must correspond to a specific value.
- Is not: Defines that the offer brand field must not correspond to a value specified in the rule.
Category
This field refers to the mapped categories or the offer field populated if the marketplace has already mapped the seller category.
- Is: Defines that the offer category field must correspond to a specific value.
- Is not: Defines that the offer category field must not correspond to a specific value.
- Has: Defines a value that must be in the seller category.
- Has not: Defines a value that must not be in the seller category.
- Filled: Defines that the "Category" field must be filled in.
Seller category
- Is: Defines that the offer Category field must correspond to a specific value.
- Is not: Defines that the offer Category field must not correspond to a specific value.
- Has: Defines a value that must be in the seller category.
- Has not: Defines a value that must not be in the seller category.
- Filled: Defines that the Category field must be filled in.
SKU specification
- Filled: Defines that the SKU specification must be filled in.
- Not filled: Defines that the SKU specification must not be filled in.
- Has: Defines a value that must be in the SKU specification.
- Has not: Defines a value that must not be in the SKU specification.
Product specification
- Filled: Defines that the product specification must be filled in.
- Not filled: Defines that the product specification must not be filled in.
- Has: Defines a value that must be in the product specification.
- Has not: Defines a value that must not be in the product specification.
Activating and deactivating requirement groups
The marketplace chooses when the requirements created will be applied to new received SKUs and even to the previous ones. So, the page allows you to activate and deactivate all requirement groups created for the filters to be applied to all the offers received by sellers.
Note that by activating the requirements, offers will be automatically rejected or submitted for manual review based on the set criteria.
Follow the steps below to activate the requirements created:
- In the VTEX Admin, go to Marketplace > Offer Quality.
- Select the
Active
option. - Check an option from:
- New offers and existing pending SKUs
- Only new offers
- Click Activate.
Select the Inactive > Confirm to deactivate.
Editing and deleting requirement groups
To edit requirement groups, on the Offer Quality filters page, select the desired group > click menu > Edit > change the desired fields > Save.
To delete requirement groups, select the desired group > click menu > Delete group > Delete.
Moving mandatory and optional requirements
You can move a requirement created as optional to mandatory and vice versa. To do this, on the Offer Quality filters page, select the desired group > click menu > Move to optional/mandatory requirements > Confirm.
Cataloging offers with requirements
Once the requirement groups have been created and activated, they take effect following the set rules. This means that all offers submitted by sellers will be filtered according to the criteria defined for sellers, brands, or categories to get to the Received SKUs page, where the cataloging process happens.
The following table describes what each requirement type triggers for offers that do or do not meet the set criteria.
Requirement type | Requirement action | Where the offers are sent |
---|---|---|
Mandatory requirements | They automatically reject offers that do not meet the set criteria and send them to the Rejected tab. | Rejected tab |
They send offers that meet the set criteria to the Pending tab. | Pending tab | |
Optional requirements | They send to the Review tab offers that don't meet the requirements. | Review tab |
They send offers that meet the set criteria to the Pending tab if they also meet the mandatory requirements. | Pending tab | |
No requirements configured | Offers are sent to the Pending tab. | Pending tab |