Skip to main content

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.

Every new Cartble store starts with a 15-day free trial on the starter_trial plan. During the trial your store is fully functional — you can add products, accept orders, and configure settings. After the trial ends you choose a paid plan to keep your store active. All payments are processed securely through Stripe.

Free trial

When you create a store, Cartble automatically places you on a 15-day free trial. Your trial starts the moment you complete onboarding. The number of days remaining is shown at the top of the Billing page in your admin dashboard.
After your trial expires, there is a 7-day grace period during which your store remains accessible. Once the grace period ends your store is locked until you activate a paid plan.

Subscription statuses

Your subscription can be in one of four states.

Trialing

Your store is on the free trial. Full access is available for 15 days from store creation.

Active

Your subscription is paid and up to date. Your store operates without restrictions.

Past due

A payment failed. Your store enters a grace period. Update your payment method to restore normal access.

Canceled

Your subscription has been canceled. If cancelAtPeriodEnd was set, access continues until the end of the current billing period.
If cancelAtPeriodEnd is enabled on your subscription, canceling does not cut off access immediately — your store stays active through the end of the period you already paid for.

Plan limits

Every plan defines a set of limits that control what your store can do. These are the fields you will see reflected in your plan.
The maximum number of products, items, or services you can create. A value of null means unlimited.
The maximum number of store blueprints (industry templates) available to your store. A value of null means unlimited.
Whether your plan includes the ability to connect a custom domain to your store. Plans without this set to true can only use the default yourstore.mycartble.com subdomain.
A monthly cap on total sales volume in your store’s currency. A value of null means no cap. If your sales exceed this limit, an overage fee applies.
The percentage fee charged on sales that exceed monthlySalesLimit. Expressed as a decimal — for example, 0.01 equals a 1% overage fee.

Plan feature flags

Higher-tier plans unlock additional capabilities through feature flags. Some features are automatically enabled based on your store’s industry, regardless of plan.
Feature flagWhat it enables
enablePreparablePreparation time tracking for orders or appointments
enableCustomizablePer-item customization options at checkout
enableSchedulableAppointment and session scheduling
enableVariantHeavyFull product variant support (sizes, colors, etc.)
enableStaffManagedStaff assignment and management for appointments
Even if your plan does not include a feature flag, Cartble may enable it automatically if it is essential for your store’s industry. For example, enableVariantHeavy is always active for retail stores and enableSchedulable is always active for booking stores.

Billing transactions

Every payment processed for your subscription is recorded as a billing transaction. Each transaction has one of three statuses.
  • Paid — the payment was successful.
  • Pending — the payment is being processed.
  • Failed — the payment was not collected. Check your payment method.
You can view your transaction history in the Billing section of your admin dashboard.

Upgrading or downgrading your plan

1

Go to Billing

In your admin dashboard, open the Billing page from the main navigation.
2

Review available plans

The page shows all active plans. Your current plan is highlighted. Plans display their price, feature list, and limits.
3

Select a plan

Click Select Plan on the plan you want. You are redirected to a Stripe-hosted checkout page to complete payment.
4

Manage payment methods

If you already have an active Stripe subscription, click Manage Payment Methods to open the Stripe billing portal where you can update your card, view invoices, or cancel.
Enterprise or “Ultra” plans require contacting the sales team directly. The Talk to Sales button on the Billing page opens a pre-filled email to start the conversation.