Every sellable thing in your store is called a resource. Regardless of whether you run a retail shop, a food-delivery operation, or a booking-based service, the same catalog system powers your listings. Cartble adapts the terminology and available fields to match your industry: resources appear as “products” in Retail, “items” in On-Demand, and “services” in Booking.Documentation Index
Fetch the complete documentation index at: https://docs.cartble.com/llms.txt
Use this file to discover all available pages before exploring further.
Resource types
Physical
Tangible goods that require shipping. Supports SKU, weight, and dimensions via the logistics bundle.
Digital
Files or links delivered after purchase. Set a download limit and an optional link expiration period.
Service
Bookable appointments or sessions. Uses the scheduling bundle for duration, staff, and buffer time.
Subscription
Recurring-billing products. Configure the billing period and an optional free trial via the subscription bundle.
Creating a resource
Navigate to Admin → Resources → All Products and click New Resource.Fill in the basics
Enter a name, description, and set the price. Prices are stored in cents — entering
1999 with currency USD represents $19.99. You can optionally set a compare-at price (the original price shown as crossed out) and a cost per item for margin tracking.Add images
Upload one or more images. The first image becomes the cover image shown in listings. You can also set a dedicated
coverImage separately.Set stock
Enter the available quantity. For services, stock represents capacity (number of available slots).
Assign categories and collections
Select one or more categories for internal taxonomy and optionally assign the resource to one or more collections for storefront grouping.
Variants
Enable Has Variations when a resource comes in multiple options (for example, Size and Color for a T-shirt).Define variation groups
Add one or more variation groups, each with a name (e.g., “Size”) and a list of options (e.g., “S”, “M”, “L”, “XL”).
Variation items override the base resource price and stock. The base price is used only when no variations are defined.
Industry-specific fields
- Retail (Physical)
- On-Demand / Food
- Booking (Service)
- Digital
- Subscription
Physical resources support a logistics bundle for shipping and tax:
| Field | Description |
|---|---|
sku | Stock keeping unit identifier |
baseSku | Base SKU shared across variants |
ncm | Fiscal classification code (used in Brazil) |
weight | Item weight in grams |
dimensions | Length, width, and height in your chosen unit |
chargeTax | Whether tax is applied at checkout |
Custom attributes and metafields
Resources support two ways to store extra data:- Attributes (
attributes[]) — structured key/value pairs with a display label and a visibility toggle. Use these for product specifications shown on the storefront. - Metafields (
metafields) — a free-form key/value map for custom data that does not need a defined schema. Manage reusable metafield definitions in Admin → Attribute Library.
SEO fields
Each resource has optional SEO fields:| Field | Description |
|---|---|
metaTitle | Custom page title for search engines (overrides the resource name) |
metaDescription | Page description shown in search results |