> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Sample Flows

## Article: Sample Flows

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/read-only-variants-v3/sample-flows.md

## Article Content:

# Read-Only Variants API: Sample Flows

This article presents possible use cases and corresponding sample flows that you can support. This can be a helpful jumping off point as you plan your implementation.

## Manage inventory across multiple products

You need to identify variants that are running low on stock across your entire catalog to prioritize restocking efforts.

To find low-stock variants:

1. Call [Search Variants](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/read-only-variants-v3/search-variants.md) to find variants that are out of stock but don't have preorders enabled: `"inventoryStatus.inStock": false`, `"inventoryStatus.preorderEnabled": false`
2. Extract the product information and variant details from the response.
3. Create alerts or reports for your inventory management system using the SKU and product name information.

## Build a variant search interface

You want to create a search feature that allows customers to find specific variants by searching product names, then filter results by price range and availability.

To implement variant search:

1. Use [Search Variants](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/read-only-variants-v3/search-variants.md) with a free-text search query for `"cotton t-shirt"`.
2. Display the matching variants with their product context (name, images) and variant-specific details (size, color, price).
3. Use cursor-based pagination to load additional results as customers scroll through the search results.

## Sync variant pricing with external systems

You have an external pricing system and need to identify variants that may need price updates by comparing SKUs and current prices.

To extract variant pricing data:

1. Call [Search Variants](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/read-only-variants-v3/search-variants.md) with merchant data to get cost and profit information: `"fields": ["MERCHANT_DATA", "CURRENCY"]`
2. Extract the SKU, current price, cost, and profit margin for each variant.
3. Compare this data with your external pricing system using the SKU as the key.
4. Identify discrepancies and use the [Products V3 API](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/products-v3/introduction.md) to update prices as needed.

## Create variant analytics dashboard

You want to analyze variant performance by tracking which option combinations are most popular and profitable.

To gather variant analytics data:

1. Call [Query Variants](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/read-only-variants-v3/query-variants.md) to get all variants with revenue details. You must pass `"fields": ["MERCHANT_DATA"]` to access cost and profit information.
2. Group variants by their option choices to analyze performance by size, color, or other attributes.
3. Calculate metrics like total profit, profit margins, and sales velocity using the cost and profit data.
4. Identify trends such as which color options generate the highest margins or which size combinations sell most frequently.