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.

Cartble’s billing system handles your subscription, plan changes, and payment history in one place. You can access it from Admin → Billing. Cartble charges zero transaction fees regardless of your plan — the only cost is your monthly or annual subscription. Payments are processed securely through Stripe.
If Cartble offers a free trial period, your plan status shows as Trialing and the number of days remaining is displayed on the Billing page. Connect your payment method before the trial ends to avoid any service interruption — your features stay active for the full trial length.

​
Subscription status

Your subscription can be in one of four states:
StatusWhat it means
ActiveYour subscription is current and all plan features are fully unlocked.
TrialingYou are in a free trial period. Features are available; no charge yet.
Past DueA payment attempt failed. Features may be restricted until payment is resolved.
CanceledYour subscription has been canceled. Access continues until the end of your current billing period.
If your status is Past Due, update your payment method as soon as possible to restore full access. Go to Admin → Billing → Manage Billing and update your card through the Stripe customer portal.

​
Plan limits

Every Cartble plan defines a set of limits that govern what your store can do. The following limits apply depending on your plan:
  • Max Resources (maxResources) — the maximum number of products or catalog items you can create. null means unlimited.
  • Max Blueprints (maxBlueprints) — the number of store blueprints (commerce types) you can activate. null means unlimited.
  • Max Storage (maxStorageGb) — total file storage available for images and digital assets, in gigabytes.
  • Monthly Sales Limit (monthlySalesLimit) — a cap on total order value processed per month, in your store’s currency. Plans with null have no cap.
  • Overage Fee (overageFeePercent) — if your store exceeds its monthly sales limit, an additional percentage fee applies to the excess. Check your plan details to see the rate for your tier.
  • Stripe Payments (enableStripePayment) — whether your plan allows connecting Stripe to accept card payments.
  • Manual Payments (enableManualPayment) — whether your plan allows manual payment methods (bank transfer, cash on delivery, etc.).
  • Smart Pricing (enableSmartPrice) — access to dynamic or intelligent pricing features.
  • Custom Domain (customDomain) — whether your plan includes the ability to connect a custom domain.
  • Max Staff Members (maxStaffMembers) — the number of team members you can invite to your admin panel.

​
Upgrading your plan

1

Open Billing

Go to Admin → Billing.
2

Choose a plan

Browse the available plans and compare their features and limits. Click Subscribe or Upgrade on the plan you want.
3

Complete checkout

You are redirected to a Stripe-hosted checkout page. Enter your payment details and confirm. Cartble creates a Stripe Checkout Session and redirects you on success.
4

Access your new features

Your new plan features are unlocked immediately after payment is confirmed. No restart or manual activation is required.
When you upgrade, your new plan limits take effect right away. If you were previously blocked from adding more products, staff, or blueprints, those restrictions are lifted the moment your upgrade completes.

​
Managing your billing details

If you need to update your credit card, download invoices, or change your billing information, click Manage Billing on the Billing page. This opens the Stripe customer portal, where you can make changes directly to your subscription and payment methods.

​
Viewing invoice history

Your transaction history shows every charge processed against your account. Each entry includes:
  • Amount — total charged, in your billing currency
  • Date — the date the transaction was created
  • Status — paid, pending, or failed
  • Invoice ID — the external reference you can use to cross-reference with Stripe

​
Canceling your subscription

To cancel, open the Stripe customer portal via Manage Billing and select the cancellation option. By default, Cartble schedules cancellation at the end of your current billing period — your store stays online and fully functional until your paid period runs out. You will not be charged again after cancellation.