> ## Documentation Index
> Fetch the complete documentation index at: https://help.experro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Catalog Settings

Catalog Settings is the catalog-wide configuration layer. While Field Settings tunes individual fields, Catalog Settings tunes behaviors that apply across the entire catalog — Gen AI vector indexing, the field used as the precision and personalization signal, out-of-stock handling, color grouping, and variant slicing attributes.

The screen has three tabs at the top: General, Color Family, and AI Knowledge.

<Frame>
  <img src="https://mintcdn.com/experro/MoVux8Fb5vsRBYTy/images/experro_discovery/search/algorithm_field_settings_catalog_settings/Catalog_General.png?fit=max&auto=format&n=MoVux8Fb5vsRBYTy&q=85&s=64fd6a2a414456053d43fdb70ba015a1" alt="" width="3360" height="1718" data-path="images/experro_discovery/search/algorithm_field_settings_catalog_settings/Catalog_General.png" />
</Frame>

## General Tab

### Allow Vector for Gen AI

Vector indexing generates a numeric embedding for each product so the Gen AI search engine can reason about semantic similarity rather than literal keyword matches. Two independent toggles control which kinds of embeddings are generated.

* **Text Vector** — Enables semantic understanding of product text content: title, description, attributes. When enabled, a search for "comfortable office chair" can surface products described as "ergonomic desk seating" even when no keywords overlap.
* **Image Vector** — Enables visual-similarity matching using product images. Required for image-based engines and for image-similarity recommendations such as Complete the Look.

<Note>
  **Prerequisite for Gen AI Engine:** The Gen AI engine and Hybrid engine choices in the Algorithm screen require at least one vector to be enabled here. If neither Text Vector nor Image Vector is on, those engine options are disabled in the Algorithm screen with a notice pointing back to Catalog Settings.
</Note>

<Warning>
  **Re-index required:** Toggling either vector on or off triggers a full re-index. Plan for a one-time index rebuild after this change.
</Warning>

### Precision & Personalization Mode

Precision & Personalization Mode picks the single field that Experro uses as the primary signal for product type — its dress-ness, shoe-ness, ring-ness. This signal drives several downstream behaviors:

* Dominant category detection when a search returns no direct category match.
* Personalization scoping — affinities are scoped to the product type represented by this field by default.
* Gen AI search fallback when literal matches are sparse.

Choose the Search Field for Categorization from the dropdown. Common choices:

* **Categories** — Works well if your category tree is well-structured and every product is tagged to a single primary category.
* **Product Type (Shopify)** — Most Shopify customers find Product Type more reliable than Categories — Categories tend to include marketing groupings such as Sale or New Arrivals that pollute precision.
* **Category Level 1** — If you have a multi-level category structure where Level 1 captures the primary type (Dresses, Shoes) and Level 2/3 captures style, Category Level 1 is often the cleanest precision signal.
* **Custom field (e.g. Style Category)** — Some customers maintain a separate, curated product-type field for exactly this purpose. If you have one, use it.

### Dominant Category or Type Identification

<Warning>
  **HIDDEN / Legacy:** This setting is labeled HIDDEN in the current UI and is retained only for backward compatibility with existing algorithms. New algorithms should use Precision & Personalization Mode above instead. The Dominant Category setting will be removed in a future release.
</Warning>

For algorithms still relying on the legacy behavior, this setting controls the sample size — how many top search results Experro examines to identify the dominant category when a query does not directly tag one. The default is 50.

### Out-of-Stock (OOS) Products

Controls how out-of-stock products are handled across the storefront. Pick one of two options.

* **Include** — Out-of-stock products continue to appear in search results and on category pages, typically with reduced ranking. Use when you want shoppers to discover OOS products (and potentially sign up for back-in-stock notifications) rather than hiding them entirely.
* **Exclude** — Out-of-stock products are removed from search results and category pages entirely. Use when displaying unavailable inventory hurts the shopping experience.

<Note>
  **How OOS is detected:** Experro uses the Inventory field from your catalog to determine stock status. Make sure the field is correctly mapped in the Catalog Connection screen so OOS detection works as expected.
</Note>

### Color Field

Tells Experro which fields in your catalog should be treated as colors for the purpose of color-family grouping and color-based merchandising. Most customers select a single Color field, but if you have multiple color-related fields — for example Dress Color on apparel and Frame Color on jewelry — include all of them. The selected fields are also the basis for the Color Family tab.

### Variant Slicing Attributes

Variant Slicing Attributes is the catalog-level list of variant attributes available for slicing on the storefront. Variant attributes you select here become available in the Algorithm screen's Variant Slicing setup and in Merchandising Variant Slicing Rules.

The picker shows every field marked as Variant Option in Field Settings. Pick the attributes you want available for slicing — typically color, size, material, metal, finish.

<Note>
  **Two layers, one feature:** Variant Slicing Attributes here defines *what* is available. The Algorithm screen's Relevance tab defines *how* the default variant is chosen. The Merchandising Variant Slicing Rule overrides the default for specific search queries or category pages.
</Note>

## Color Family Tab

The Color Family tab manages how visually-similar colors are grouped together so that a search for one color also surfaces close matches. For example, a search for "red" can surface burgundy, scarlet, and maroon when these are grouped into a single family.

Experro ships with a predefined color library covering the most common groupings (reds, greens, blues, neutrals, and so on). Future releases will support customer-defined libraries built from your own catalog data.

<Frame>
  <img src="https://mintcdn.com/experro/MoVux8Fb5vsRBYTy/images/experro_discovery/search/algorithm_field_settings_catalog_settings/Catalog_Color.png?fit=max&auto=format&n=MoVux8Fb5vsRBYTy&q=85&s=dc6689d68a1ad88e233e31960d75da8a" alt="" width="3360" height="1722" data-path="images/experro_discovery/search/algorithm_field_settings_catalog_settings/Catalog_Color.png" />
</Frame>
