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

# Cartble subscription plans, trials, and billing

> Understand Cartble's free trial, subscription statuses, plan limits, feature flags, and how to upgrade or manage your billing through Stripe.

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.

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

## Subscription statuses

Your subscription can be in one of four states.

<CardGroup cols={2}>
  <Card title="Trialing" icon="clock">
    Your store is on the free trial. Full access is available for 15 days from store creation.
  </Card>

  <Card title="Active" icon="circle-check">
    Your subscription is paid and up to date. Your store operates without restrictions.
  </Card>

  <Card title="Past due" icon="triangle-alert">
    A payment failed. Your store enters a grace period. Update your payment method to restore normal access.
  </Card>

  <Card title="Canceled" icon="ban">
    Your subscription has been canceled. If `cancelAtPeriodEnd` was set, access continues until the end of the current billing period.
  </Card>
</CardGroup>

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

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

<AccordionGroup>
  <Accordion title="maxResources">
    The maximum number of products, items, or services you can create. A value of `null` means unlimited.
  </Accordion>

  <Accordion title="maxBlueprints">
    The maximum number of store blueprints (industry templates) available to your store. A value of `null` means unlimited.
  </Accordion>

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

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

  <Accordion title="overageFeePercent">
    The percentage fee charged on sales that exceed `monthlySalesLimit`. Expressed as a decimal — for example, `0.01` equals a 1% overage fee.
  </Accordion>
</AccordionGroup>

## 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 flag         | What it enables                                      |
| -------------------- | ---------------------------------------------------- |
| `enablePreparable`   | Preparation time tracking for orders or appointments |
| `enableCustomizable` | Per-item customization options at checkout           |
| `enableSchedulable`  | Appointment and session scheduling                   |
| `enableVariantHeavy` | Full product variant support (sizes, colors, etc.)   |
| `enableStaffManaged` | Staff assignment and management for appointments     |

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

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

<Steps>
  <Step title="Go to Billing">
    In your admin dashboard, open the **Billing** page from the main navigation.
  </Step>

  <Step title="Review available plans">
    The page shows all active plans. Your current plan is highlighted. Plans display their price, feature list, and limits.
  </Step>

  <Step title="Select a plan">
    Click **Select Plan** on the plan you want. You are redirected to a Stripe-hosted checkout page to complete payment.
  </Step>

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

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