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

# Settings

In Commerce Studio's settings, you can configure what the [Editor](/docs/lw-platform/lw-cs/cstudio-editor) displays for each search profile.
Some of these settings require the names of data fields in Fusion, but you can type to search for the fields you need.
In your site on Lucidworks Platform, navigate to **Commerce Studio** > **Settings** to access these settings.

Start by selecting a search profile to configure.
Search profiles represent different predefined search results that you can display on different pages of your customer-facing site, such as new items, seasonal items, sale items, and so on.
You might also have experimental search profiles for testing different configurations.
The configuration you create here determines how the item cards are displayed in the Editor when the same search profile is selected.

<Frame>
  <img src="https://mintcdn.com/lucidworks/2b9yyNKfDTYuhcWc/assets/images/lw-platform/commerce-studio/lw-cs-settings-profile-select.png?fit=max&auto=format&n=2b9yyNKfDTYuhcWc&q=85&s=edd28a82db06280eebc7ca0271d65c91" alt="Select a search profile" width="2558" height="1016" data-path="assets/images/lw-platform/commerce-studio/lw-cs-settings-profile-select.png" />
</Frame>

## Configure Search Results

In the **Search Results** section, you can configure the fields displayed for each result item in the Editor.
Once you configure these settings, you can turn different display fields on or off while you're working in the Editor using its [Preview Settings](/docs/lw-platform/lw-cs/cstudio-editor#configure-the-item-card-display).

<Frame>
  <img src="https://mintcdn.com/lucidworks/2b9yyNKfDTYuhcWc/assets/images/lw-platform/commerce-studio/lw-cs-settings-search-results.png?fit=max&auto=format&n=2b9yyNKfDTYuhcWc&q=85&s=dc25e4aa8d294da6f8854b54e502e7b2" alt="Configure search results" width="2090" height="1690" data-path="assets/images/lw-platform/commerce-studio/lw-cs-settings-search-results.png" />
</Frame>

### Fields Style

Under **Fields Style**, you can select and format the fields that the preview cards display in the Editor.

* To add a field, click the <Icon icon="circle-plus" size={24} /> button.
* To change a field, click the field and type to search for another one.
* To change a field's display style, click the dropdown and select the style that best matches the field's data type.

### Variants

When you enable Variants, you can select the fields that contain data about different variants of your products. To enable product grouping in Commerce Studio, follow the procedure for your configuration.

<Tabs>
  <Tab title="Core Settings">
    If you are using Core Settings, enable product grouping in the Lucidworks Platform UI.

    <Steps>
      <Step title="Turn it on">
        Go to **Core Settings** > **Relevance** and turn on **Product Grouping**:

        <Frame caption="Product Grouping toggle in Core Settings">
          <img src="https://mintcdn.com/lucidworks/8GeHMfZ_Pzc-4YpW/assets/images/lw-platform/core-settings/product-grouping.png?fit=max&auto=format&n=8GeHMfZ_Pzc-4YpW&q=85&s=66ab01620ba986afafa89d50ce608573" alt="Product Grouping toggle in Core Settings" width="766" height="142" data-path="assets/images/lw-platform/core-settings/product-grouping.png" />
        </Frame>
      </Step>

      <Step title="Configure Commerce Studio">
        Go to **Commerce Studio** > **Settings** and configure these options:

        <Frame caption="Variant settings in Commerce Studio">
          <img src="https://mintcdn.com/lucidworks/8GeHMfZ_Pzc-4YpW/assets/images/lw-platform/commerce-studio/lw-cs-settings-variants.png?fit=max&auto=format&n=8GeHMfZ_Pzc-4YpW&q=85&s=c0f516ddb79162e2535b1d4673ca3e16" alt="Variant settings in Commerce Studio" width="1503" height="514" data-path="assets/images/lw-platform/commerce-studio/lw-cs-settings-variants.png" />
        </Frame>

        <ResponseField name="Variant Field Name" type="string">
          The Fusion field containing visual data (image or color) used for variant swatches on the product card. For visual display purposes only.
        </ResponseField>

        <ResponseField name="Variant Field Type" type="enum">
          Specifies whether the variant field name contains an `image` or `color`, determining which type of swatch Commerce Studio displays. For visual display purposes only.
        </ResponseField>

        <ResponseField name="Variant SKU ID" type="string">
          The field containing IDs of individual products collapsed into a single group in the Editor. This information is used for visual display of variant swatches and for creating rules to rerank products within the group.
        </ResponseField>
      </Step>

      <Step title="Verify your settings">
        Save your changes, then visit the Editor to verify that items are correctly grouped.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Fusion">
    If you are using Fusion, configure grouping in your query pipeline. Then, configure grouping in Commerce Studio.

    <Steps>
      <Step title="Open your query pipeline">
        In Fusion, open the query pipeline for which you want to configure grouping.
      </Step>

      <Step title="Add query parameterss">
        The query profile must pass a `fq`, `expand`, and `expand.rows` query parameters.

        1. Add a new **Additional Query Parameters** pipeline stage or edit an existing one.

        2. Add the following query parameters:

                   <ResponseField name="fq" type="string">
                     <Expandable title="Parameters and Values">
                       <ResponseField name="Parameter Name" type="string" required>
                         `fq`
                       </ResponseField>

                       <ResponseField name="Parameter Value" type="string" required>
                         `{!collapse field=FIELD_NAME}`
                       </ResponseField>

                       <ResponseField name="Update Policy" type="enum" required>
                         `default`
                       </ResponseField>
                     </Expandable>
                   </ResponseField>

                   <ResponseField name="expand" type="boolean">
                     <Expandable title="Parameters and Values">
                       <ResponseField name="Parameter Name" type="string" required>
                         `expand`
                       </ResponseField>

                       <ResponseField name="Parameter Value" type="boolean" required>
                         `true`
                       </ResponseField>

                       <ResponseField name="Update Policy" type="enum" required>
                         `default`
                       </ResponseField>
                     </Expandable>
                   </ResponseField>

                   <ResponseField name="expand.rows" type="number">
                     <Expandable title="Parameters and Values">
                       <ResponseField name="Parameter Name" type="string" required>
                         `expand.rows`
                       </ResponseField>

                       <ResponseField name="Parameter Value" type="number" required>
                         The number of variant swatches displayed on each product card in Commerce Studio. For example, `5` displays 5 variant swatches on the product card. All variants are included in the response regardless of this value. This parameter must be set in Fusion or in the same Set Parameter Rule as the collapse parameter.
                       </ResponseField>

                       <ResponseField name="Update Policy" type="enum" required>
                         `default`
                       </ResponseField>
                     </Expandable>
                   </ResponseField>

        3. Save the pipeline stage and pipeline configuration.

        4. Verify that your query pipeline passes the query parameters you set up in previous steps. In the query workbench, open the **View As** selector and select JSON. Navigate to `responseHeader.params` in the response.

                   <Frame caption="Query parameters in the response JSON">
                     <img src="https://mintcdn.com/lucidworks/8GeHMfZ_Pzc-4YpW/assets/images/lw-platform/commerce-studio/lw-cs-settings-variants-fusion-json.png?fit=max&auto=format&n=8GeHMfZ_Pzc-4YpW&q=85&s=cde903377330784da635b70380ccde49" alt="Query parameters in the response JSON" width="2048" height="1035" data-path="assets/images/lw-platform/commerce-studio/lw-cs-settings-variants-fusion-json.png" />
                   </Frame>

                   <Note>
                     Setting a parameter requires proper Solr syntax. If you receive errors in Commerce Studio after completing these steps, verify that you set up these parameters correctly.
                   </Note>
      </Step>

      <Step title="Configure Commerce Studio">
        Go to **Commerce Studio** > **Settings** and configure these options:

        <Frame caption="Variant settings in Commerce Studio">
          <img src="https://mintcdn.com/lucidworks/8GeHMfZ_Pzc-4YpW/assets/images/lw-platform/commerce-studio/lw-cs-settings-variants.png?fit=max&auto=format&n=8GeHMfZ_Pzc-4YpW&q=85&s=c0f516ddb79162e2535b1d4673ca3e16" alt="Variant settings in Commerce Studio" width="1503" height="514" data-path="assets/images/lw-platform/commerce-studio/lw-cs-settings-variants.png" />
        </Frame>

        <ResponseField name="Variant Field Name" type="string">
          The Fusion field containing visual data (image path or color) used for variant swatches on the product card. This information is used for visual display purposes only.
        </ResponseField>

        <ResponseField name="Variant Field Type" type="enum">
          Specifies whether the variant field name contains an `image` or `color`, determining which type of swatch Commerce Studio displays. This information is used for visual display purposes only.
        </ResponseField>

        <ResponseField name="Variant SKU ID" type="string">
          The field containing IDs of individual products collapsed into a single group in the Editor. This information is used for visual display of variant swatches and for creating rules to rerank products within the group.
        </ResponseField>

        <Note>
          These configurations determine how products with variants are visualized in the Editor.
        </Note>
      </Step>

      <Step title="Verify your settings">
        Save your changes, then visit the Editor to verify that items are correctly grouped.
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Tip>
  For conditional, rule-based grouping that can vary based on queries, categories, or other conditions, see [advanced grouping](/docs/lw-platform/lw-cs/cstudio-rules#advanced-grouping) in the Rules documentation.
</Tip>

### Inline Analytics

When you configure and use the signals beacon and Analytics Studio to collect and display signal information, you can also enable Inline Analytics, which lets you select the metrics to display in the preview cards, along with the duration reflected by the metrics.

The metrics you can select to display on the product preview cards include Impressions, Add-To-Cart (ATC), Orders, Sales, Revenue Per Visit (RPV), and Conversion Rate (CVR).

Navigate to Inline Analytics, and in the Metrics section, select the options you want to display on all product cards.

<Frame>
  <img src="https://mintcdn.com/lucidworks/WPuIFZR2sHwJg_cD/assets/images/lw-platform/commerce-studio/lw-cs-settings-inline-analytics.png?fit=max&auto=format&n=WPuIFZR2sHwJg_cD&q=85&s=1cde9cdf94b700794999d9b529c4770e" alt="Commerce Studio setting for Inline Analytics Metrics" width="600" data-path="assets/images/lw-platform/commerce-studio/lw-cs-settings-inline-analytics.png" />
</Frame>

The product card displays the metrics for each specific product in Commerce Studio Editor.

<Frame>
  <img src="https://mintcdn.com/lucidworks/WPuIFZR2sHwJg_cD/assets/images/lw-platform/commerce-studio/lw-cs-product-card-impression-metrics.png?fit=max&auto=format&n=WPuIFZR2sHwJg_cD&q=85&s=f35e9e444f9470337f69a3ddde10f6f7" alt="Commerce Studio Editor product card with metrics" width="250" data-path="assets/images/lw-platform/commerce-studio/lw-cs-product-card-impression-metrics.png" />
</Frame>

The Preview Settings panel in Commerce Studio Editor lets you toggle the metrics on or off to display on result cards. You can select up to three metrics at a time.

<Frame>
  <img src="https://mintcdn.com/lucidworks/WPuIFZR2sHwJg_cD/assets/images/lw-platform/commerce-studio/lw-cs-product-details-metrics-impressions.png?fit=max&auto=format&n=WPuIFZR2sHwJg_cD&q=85&s=f683adc800611339ea9830019faec0b2" alt="Commerce Studio Editor Preview Settings to set metrics for a specific product" width="350" data-path="assets/images/lw-platform/commerce-studio/lw-cs-product-details-metrics-impressions.png" />
</Frame>

## Configure categories

In the Editor, you can create and manage rules that apply within specific categories of items in your catalog.
To enable category-level search optimization in the Editor, you need to set the category field here.

Type to search for the data field that contains your site's categories, such as `category_s`.
When you select a field, this section displays example values found in that field so you can verify that the field you selected contains the data you need.

<Frame>
  <img src="https://mintcdn.com/lucidworks/2b9yyNKfDTYuhcWc/assets/images/lw-platform/commerce-studio/lw-cs-settings-category.png?fit=max&auto=format&n=2b9yyNKfDTYuhcWc&q=85&s=2c9856734a7ad24010ddca8202ef3bfa" alt="Configure categories" width="2088" height="1448" data-path="assets/images/lw-platform/commerce-studio/lw-cs-settings-category.png" />
</Frame>

Once you've selected the category field here, you can [use category conditions](/docs/lw-platform/lw-cs/cstudio-editor#use-category-conditions) in the Editor to access the available categories and optimize the results for each one.

## Configure typeahead

Typeahead, also known as autocomplete or autosuggest, is a feature that provides real-time query and phrase suggestions as you type in the Editor's search bar.
In the Typeahead section, you can configure the fields to use for typeahead for this search profile.

<Frame>
  <img src="https://mintcdn.com/lucidworks/2b9yyNKfDTYuhcWc/assets/images/lw-platform/commerce-studio/lw-cs-settings-typeahead.png?fit=max&auto=format&n=2b9yyNKfDTYuhcWc&q=85&s=478598cbaa938a93ac5c46cb93709f7c" alt="Configure typeahead" width="2094" height="1336" data-path="assets/images/lw-platform/commerce-studio/lw-cs-settings-typeahead.png" />
</Frame>

* To add a field, click the <Icon icon="circle-plus" size={24} /> button.
* To change a field, click the field and type to search for another one.
* To change a field's display style, click the dropdown and select the style that best matches the field's data type.

<Note>
  The Commerce Studio Settings Typeahead feature is for internal use in Commerce Studio. This is different than the [Lucidworks Platform Core Settings Typeahead feature](/docs/lw-platform/lw-core/sites-typeahead), which is where typeahead options for customer queries is configured.
</Note>
