How to Configure Advanced Settings in Shoply AI

This page covers various settings that can be configured through the Advanced Settings JSON in your Shoply AI admin panel.

Where to find Advanced Settings?

Go to the “Settings” section of the app’s admin console, and then scroll down to the “Advanced Settings” section. In this section, you can provide a JSON object to configure various settings.

For geographic access rules, see how to restrict chatbot availability by country.

Disable Option Swatches

By default, Shoply AI displays visual option swatches below the product image in search and chat results. These swatches appear for product variants that have different images (e.g., different colors or patterns). Clicking a swatch updates the displayed image and price to reflect that variant.

If you prefer not to show option swatches, add the following to your Advanced Settings JSON:

json


{
  "disable_option_swatches": true
}

This will hide the swatches from all search and chat results, and products will display only their default image and price.

Enable Multiple Warehouses

If your store ships from multiple warehouses that serve different countries or regions, you can enable multi-warehouse support. When enabled, product availability is determined by whether the warehouse responsible for the customer’s location has inventory for that product, rather than using a single global inventory status.

The Sports Basement case study shows store-level inventory in practice.

By default this is disabled, meaning all customers see the same inventory availability regardless of their location.

To enable it, add the following to your Advanced Settings JSON:

json


{
  "enable_multiple_warehouses": true
}

Once enabled, Shoply AI will check inventory at the relevant warehouse when determining whether a product is in stock for a given customer.

Speed Up Search by Disabling AI Relevance Check

By default, Shoply AI performs an AI-powered relevance check on search results to ensure the products shown are truly relevant to the customer’s query. This improves result quality but adds some latency to search responses.

Our latency guide explains the tradeoffs behind search speed and answer quality.

If you prefer faster search results and are willing to accept that some results may not always be relevant, you can disable this check:

json


{
  "disable_ai_relevance_check_in_search": true
}

This will skip the AI relevance filtering step, making search responses significantly faster. The trade-off is that some products returned may not be as closely related to the search query.

Index Product Tags

By default, Shoply AI does not index your products’ Shopify tags. Tags are often used for internal or operational purposes (for example, supplier-acme, black-friday-2024, or do-not-restock), and including them in search would add noise and reduce result relevance.

If tags contain several attributes, see how to convert product tags into structured fields.

If your tags instead describe things customers actually search for — such as materials, features, use cases, or brands (e.g., waterproof, vegan, gift-for-her) — you can opt in to make them searchable by adding the following to your Advanced Settings JSON:

json


{
  "index_tags": true
}

Once enabled, each product’s tags are added to its searchable text and included when Shoply AI builds the product’s embedding, so customers can find products by their tag terms in both search and chat.

This applies the next time your catalog is indexed, so allow some time (or trigger a re-index) for it to take effect on existing products. Since your tags will then influence results, review them first to make sure they are customer-appropriate.

Limit Number of Products in Chat

By default, when the AI chatbot recommends products in a conversation, it may show several results per recommendation. In a single chat session, the AI may make multiple product recommendations (e.g., suggesting running shoes, then socks). This setting controls how many products are shown per recommendation:

json


{
  "product_limit_in_chat": 3
}

For example, with a limit of 3, if the AI recommends both shoes and socks in a conversation, it will show up to 3 shoes and up to 3 socks. This setting only applies to the chat experience — AI Search results are not affected. If the limit is set below 4, product filters will also be hidden automatically.

Hide Search Filters

By default, Shoply AI shows filter buttons above product results (for example, “Brand”, “Price”, or “Color”) so customers can narrow down what they see. These are generated automatically from your catalog.

Before removing filters, understand automatically generated filters and how their source data affects the choices shoppers see.

To hide the entire filter bar:

Open Shoply AI in your Shopify admin.
Go to Customize AI Search.
Under Search filters, turn off Show filters in search results.
Click Save.

To show the filters again, turn the same option on and click Save. Your choice is saved and remains in place after refreshing the page.

This control updates the same setting as the existing hide_filters option. If you already use Advanced Settings JSON, that method is still supported:

json


{
  "hide_filters": true
}

Both methods hide filter controls from AI Search and chat product results. Products and recommendations still appear. Hiding the bar does not delete product data or remove old metafields from your catalog.