> ## Documentation Index
> Fetch the complete documentation index at: https://docs.depict.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Settings
> The Settings page and your plan: products, sizes and limits, product badge thresholds, the collection grid, market groups, catalog sync, integrations, and AI assistants.
The **Settings** page in the Depict: Search & Merchandising app holds the
store-wide configuration, in four tabs:
| Tab | Holds |
| - | - |
| **Store** | Your plan, the app's appearance, and catalog sync |
| **Merchandising** | Product badge thresholds, the collection grid, and market groups |
| **Connections** | Instagram, connected stores, and AI assistants |
| **Support** | Contacting Depict, and referring a store |
Your plan itself is managed on the separate **Plan** page, covered
[below](#your-plan).
In the embedded app, changes to the theme, the collection grid, product
badges and sold-out products are saved with the Shopify save bar; in the
standalone portal they save automatically. Market groups, Instagram and AI
assistant changes save immediately in both.
## Limits and behavior
* For 7 days after install, the store is on an Unlimited Trial with no
collection limit. After it, the Free plan allows at most 3 live
collections.
* Paid plans are built from products (Merchandising, Search,
Recommendations) at a size set by your monthly storefront sessions: Small,
Medium, Large or Custom.
* A store without a paid plan that has more than 3 live collections is
frozen: editing is blocked and a banner is shown. The configuration is
kept; choosing a plan or deactivating collections unfreezes it.
* Saving product badge settings re-sorts every active collection
(badge-based rules are recomputed against the new thresholds).
* Changes you make in Shopify reach Depict within about 2 minutes. Deleting
or archiving a product in Shopify removes it from Depict.
* The Stores card appears only on plans that include multi-store. Market
groups and the sold-out setting appear only for stores with multiple
Shopify markets.
## Your plan
The **Your plan** card on the Store tab shows your current plan and this
month's session usage. **Open Plan** — or **Plan** in the sidebar — opens the
Plan page, which shows:
* **Usage** — storefront sessions this month against your allowance, the
projected total for the month, and when the count resets. On the Free plan
it shows live collections against the limit of 3 instead.
* **Products** — Merchandising, Search and Recommendations, each marked as in
your plan, live, or not in your plan, with a button to open or add it.
After you add Search or Recommendations, Depict sets it up for you and
gets in touch.
* **Change plan** — pick products, a size and a billing period (monthly or
yearly; yearly costs less). The summary shows the price and the session
allowance before you confirm.
* **Sessions** — how sessions are counted: page views from one browser
within 30 minutes are one session.
Changing plans goes through Shopify's own approval flow: nothing changes
until you confirm in Shopify, and billing runs through your Shopify invoice.
Moving to a more expensive plan applies right away; moving to a cheaper plan,
or from yearly to monthly billing, applies at the next billing cycle.
**Switch to Free** asks you to choose up to 3 collections to keep live; the
others are deactivated and their pins removed.
What each part of a plan unlocks:
| Capability | Requires |
| - | - |
| More than 3 live collections | Merchandising |
| Bulk actions on the Collections page | Merchandising |
| Collection preview without a watermark | Any paid plan |
| Collection versions | Merchandising, Medium or larger |
| Scheduled publishing | Merchandising, Large or Custom |
| [A/B testing](/shopify-lite/ab-testing) | Merchandising, Large or Custom |
| [Multi-store](/shopify-lite/multi-store) | Merchandising, Large or Custom |
| Search | Search |
| [Recommendations](/shopify-lite/recommendations) | Recommendations |
During the Unlimited Trial, everything in Merchandising except multi-store
is available.
Stores on the earlier Basic, Essential, Pro or Custom plans keep them
unchanged until they switch to one of the new plans. They include
Merchandising at the matching size — Basic as Small (50,000 sessions a
month), Essential as Medium (250,000), Pro as Large (500,000) and Custom as
Custom — and the Plan page shows them as a legacy plan.
## Appearance
**Theme** (Light / Dark / System) controls the app's own appearance, not the
storefront.
## Catalogue
Shows when the catalog was last synced from Shopify. Syncing is automatic:
changes you make in Shopify arrive within about 2 minutes. If something
looks wrong, contact support.
## Product badges
On the Merchandising tab, **Product badges** defines which products carry the
computed badges used by [Boost & Bury rules](/shopify-lite/boost-and-bury)
and shown in the editor:
| Badge | Defined by | Options |
| - | - | - |
| Bestseller | The top N products sold in the last 30 days | 5, 10, 30 or 50 products |
| Trending | The top N products sold in the last 7 days | 5, 10, 30 or 50 products |
| New in | Published in the last N days (or created, if never published) | 1, 7, 30, 90 or 180 days |
| On Sale | Has a discount | — |
| Slow mover | The bottom N products by sell-through rate in the last 30 days | 5, 10, 30 or 50 products |
| Low on Stock | Fewer than N% of variants in stock | 10–60% |
| Out of stock | No variants left in stock | — |
The **New in** window also decides the order of collections sorted by Newest
in or Oldest in.
Saving product badge settings triggers a re-sort of every active collection,
since badge-based sorting rules are recomputed against the new thresholds.
## Collection grid
* **Desktop columns** (3–6) and **Mobile columns** (1–3) set the collection
grid's column counts (defaults: 4 desktop, 2 mobile). These are the column
counts used in content-card [slot placement](/shopify-lite/troubleshooting#empty-spaces-in-the-grid-when-using-content-cards).
* **Hide sold-out products** hides out-of-stock products on every
Depict-enabled collection page. Shown only for stores with multiple Shopify
markets.
## Market groups
Shown in the **Markets** card for stores with multiple Shopify markets.
Market groups bundle markets that share merchandising and analytics, so a
single collection version can target all of them at once.
* Create a group with **Add Market Group** (or **Create Market Group** when
there are none yet): name it and select its markets.
* Each group can be switched on and off.
Disabling a market group that is used by active collection versions stops
data ingestion for those markets — the versions remain, but their metrics
stop updating. The app warns before you confirm.
## Instagram
On the Connections tab: connect a Meta for Business account to import
Instagram media into content cards in the collection editor. The connection
can be removed at any time from the same card.
## Stores
On the Connections tab, on plans that include multi-store. Lists the store's
multi-store connections and links to the connection editors. Connecting,
mapping and replication are documented on the
[Multi-store](/shopify-lite/multi-store) page.
## AI assistants
Shown in **Settings → Connections** when Depict has turned on AI assistants
for the store. The card holds the store's MCP endpoint URL and the Claude Code
and Codex commands, each with a copy button, links to the setup guide, and
lists the connected assistants with a **Revoke** button for each. In a
multi-store group it also lists the endpoints of the group's other stores. When an assistant asks to connect, its approval
request opens at the top of this card. Connecting, approving and revoking are
documented on the [AI assistants](/shopify-lite/ai-assistants) page.
## Support
The **Talk to us** card opens a support ticket (Depict replies within a
working day) and, on plans with Merchandising at Large or Custom, offers
booking a 15-minute onboarding session once theme onboarding has finished.
**Refer a store** shares a friend's contact: when they try Depict, you both
get a free month.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.