> 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 Use Cases and Flows

## Article: Sample Use Cases and Flows

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/ribbons-v3/sample-use-cases-and-flows.md

## Article Content:

# Ribbons 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.

## Create a product with a new ribbon

To create a product and assign a new ribbon with a single API call:
Call [Create Product](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/products-v3/create-product.md) and pass
a new `product.ribbon.name` to the `product.ribbon` field.

Note: if you pass the `ribbon.name` of a ribbon you've already created, that ribbon will be assigned to the product.

## Assign an existing ribbon to a product

The Ribbons API allows you to create, update, and manage multiple ribbons. You can then use and reuse these ribbons and assign them across multiple products.

To create and assign a ribbon to a product:

1. Call [Create Ribbon](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/ribbons-v3/create-ribbon.md).
2. Save the `ribbon.id` or `ribbon.name` from your newly created ribbon.
3. Call [Create Product](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/products-v3/create-product.md) or [Update Product](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/products-v3/update-product.md), and pass either the `ribbon.id` or the `ribbon.name` to the `product.ribbon` field.