Skip to main content

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.

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:

Physical

Tangible goods that require shipping. Supports weight, dimensions, SKU, and stock-level tracking.

Digital

Files or links delivered electronically. Supports file upload, external URL, download limits, and link expiration.

Service

Bookable or time-based offerings. Supports duration, staff assignment, buffer time, and capacity.

Subscription

Recurring-access products. Linked to a subscription bundle for billing cycle and access management.

​
Adding a product

1

Open the catalog

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”).
2

Fill in the core details

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.
3

Upload images

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.
4

Set stock and SKU

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.
5

Assign categories

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.
6

Set status and save

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:
FieldDescription
Digital fileUpload a file directly to Cartble’s storage
External URLPaste a link to a file hosted elsewhere (e.g., Google Drive, Dropbox)
Download limitMaximum number of times the link can be downloaded (leave blank for unlimited)
Link expiration daysNumber of days after purchase before the download link expires
Delivery instructionsCustom 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

StatusBehavior
DraftNot visible on the storefront. Use while building out the resource.
ActiveLive and purchasable on the storefront.
ArchivedHidden from the storefront but preserved in your catalog. Useful for seasonal items or discontinued products.