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

# Manage your Cartble plan, subscription, and billing

> Choose a plan, review your invoice history, manage your Stripe subscription, and understand the plan limits that apply to your store.

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.

<Tip>
  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.
</Tip>

## Subscription status

Your subscription can be in one of four states:

| Status       | What it means                                                                                       |
| ------------ | --------------------------------------------------------------------------------------------------- |
| **Active**   | Your subscription is current and all plan features are fully unlocked.                              |
| **Trialing** | You are in a free trial period. Features are available; no charge yet.                              |
| **Past Due** | A payment attempt failed. Features may be restricted until payment is resolved.                     |
| **Canceled** | Your subscription has been canceled. Access continues until the end of your current billing period. |

<Warning>
  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.
</Warning>

## 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:

<Accordion title="Resources & catalog">
  * **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.
</Accordion>

<Accordion title="Sales & payments">
  * **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.
</Accordion>

<Accordion title="Domains & team">
  * **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.
</Accordion>

## Upgrading your plan

<Steps>
  <Step title="Open Billing">
    Go to **Admin → Billing**.
  </Step>

  <Step title="Choose a plan">
    Browse the available plans and compare their features and limits. Click **Subscribe** or **Upgrade** on the plan you want.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Access your new features">
    Your new plan features are unlocked immediately after payment is confirmed. No restart or manual activation is required.
  </Step>
</Steps>

<Note>
  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.
</Note>

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