This page covers various settings that can be configured through the Advanced Settings JSON in your Shoply AI admin panel.
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.
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:
{
"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.
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.
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:
{
"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.
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.
If you prefer faster search results and are willing to accept that some results may not always be relevant, you can disable this check:
{
"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.