> ## Documentation Index
> Fetch the complete documentation index at: https://help.cartble.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Add, edit, and manage products in your Cartble store
> Learn how to create, organize, and manage your catalog resources — from physical products to digital files, services, and subscriptions.
In Cartble, everything you sell is called a **Resource**. The term is intentionally broad: a resource can be a physical product, a digital file, a bookable service, or a recurring subscription — your active blueprint determines the language you see in the admin (for example, a food blueprint shows "Dishes" instead of "Resources"). This unified model means the same workflow applies no matter what type of store you run.
## Resource types
Cartble supports four core resource types that you set when creating an item:
Tangible goods that require shipping. Supports weight, dimensions, SKU, and stock-level tracking.
Files or links delivered electronically. Supports file upload, external URL, download limits, and link expiration.
Bookable or time-based offerings. Supports duration, staff assignment, buffer time, and capacity.
Recurring-access products. Linked to a subscription bundle for billing cycle and access management.
## Adding a product
In your admin sidebar, navigate to **Catalog**, then click **New Resource** (your blueprint may show a different label, such as "New Dish" or "New Service").
Enter the resource **name**, **description**, and **price**. If the item has a compare-at price (for showing a sale), enter it in the **Compare at price** field. Add a **cost per item** if you want margin tracking on the dashboard.
Drag and drop or select images. The first image becomes the default listing image. You can designate any image as the **cover image** — this is what appears in featured placements and collection cards.
Enter the current **stock level**. For physical items, add the **SKU** in the Logistics panel. The dashboard surfaces out-of-stock and low-stock alerts based on these values.
Select one or more **categories** to organize this resource in your taxonomy. Categories drive navigation filters and on-site search. You can also assign the resource to **collections** if you want it to appear in curated groups.
Choose a **status** — `draft` to keep it hidden while you work, `active` to publish it to the storefront, or `archived` to hide it without deleting it. Click **Save** to create the resource.
Mark a resource as **Featured** and set a clear **cover image** to make it eligible for homepage featured sections. Featured resources are prioritized in the Featured Collection storefront section.
## Product variations
If a product comes in multiple options — such as different sizes, colors, or materials — you can use variation groups to manage each combination with its own price, stock, and SKU.
**To add variations:**
1. Enable **Has Variations** on the resource form.
2. Create one or more **Variation Groups** (e.g., `Size` with options `S`, `M`, `L`, `XL`; or `Color` with options `Black`, `White`).
3. Cartble generates a **variation matrix** — one entry per combination (e.g., `Size: M / Color: Black`).
4. For each combination, set the individual **price**, **compare-at price**, **stock**, and **SKU**.
When variations are active, the top-level price acts as a fallback display price. Stock and SKU are tracked per variation item, not at the parent level.
## Modifier groups
For food and service resources, you can attach **modifier groups** — optional or required add-ons that customers configure at checkout. Common examples include sauce choices, extra toppings, or session add-ons.
Each modifier group has:
* A **name** (e.g., "Choose your sauce")
* A **min selection** and **max selection** to control how many options a customer must or can pick
* A list of **modifiers**, each with its own name and additional price
## Digital resources
When the resource type is set to **Digital**, the Logistics panel is replaced with digital delivery fields:
| Field | Description |
| ------------------------- | ------------------------------------------------------------------------------ |
| **Digital file** | Upload a file directly to Cartble's storage |
| **External URL** | Paste a link to a file hosted elsewhere (e.g., Google Drive, Dropbox) |
| **Download limit** | Maximum number of times the link can be downloaded (leave blank for unlimited) |
| **Link expiration days** | Number of days after purchase before the download link expires |
| **Delivery instructions** | Custom message shown to the buyer after purchase |
## Metafields
Metafields let you attach custom structured data to any resource — useful for technical specifications, certifications, compatibility information, or any attribute your theme or integrations need. Each metafield has a **key**, **label**, **value**, and a **visible** toggle that controls whether it renders on the storefront.
## Product statuses
| Status | Behavior |
| ------------ | ------------------------------------------------------------------------------------------------------------- |
| **Draft** | Not visible on the storefront. Use while building out the resource. |
| **Active** | Live and purchasable on the storefront. |
| **Archived** | Hidden from the storefront but preserved in your catalog. Useful for seasonal items or discontinued products. |