> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecomwize.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Your Subscription

> Learn how to view invoices, update payment methods, and manage your EcomWize Builder subscription.

You can manage your subscription, view invoices, and update payment methods through the billing portal.

## Accessing the Billing Portal

<Steps>
  <Step title="Open User Settings">
    Click on your profile or settings icon to open the User Settings modal.
  </Step>

  <Step title="Go to the Plans & Billing tab">
    Select the **Plans & Billing** tab. Here you can see your current plan, credit balance, and billing options.
  </Step>

  <Step title="Click Manage Subscription">
    If you are on a paid plan (Starter or Pro), click the **Manage Subscription** button to open the billing portal where you can manage payment methods, view invoices, and more.
  </Step>
</Steps>

<Note>
  The "Manage Subscription" button is only visible for users on paid plans. Free plan users see the option to change their plan instead.
</Note>

## What You Can Do in the Billing Portal

The billing portal provides full self-service billing management:

<CardGroup cols={2}>
  <Card title="View invoices">
    Access your complete invoice history, download PDF invoices, and view payment details for each billing cycle.
  </Card>

  <Card title="Update payment method">
    Add, remove, or change your credit card or payment method.
  </Card>

  <Card title="View upcoming charges">
    See your next billing date and the amount that will be charged.
  </Card>

  <Card title="Update billing details">
    Change your billing address, company name, or tax ID for invoices.
  </Card>
</CardGroup>

## Canceling Your Subscription

You can cancel your subscription from the Plans & Billing tab in User Settings:

<Steps>
  <Step title="Open User Settings">
    Open User Settings and go to the **Plans & Billing** tab. Click **Change Plan** to open the pricing modal.
  </Step>

  <Step title="Select the Free plan">
    Click the "Switch to Free" button on the Free plan card. A confirmation dialog appears.
  </Step>

  <Step title="Complete the cancellation survey">
    Before canceling, you are asked to share why you are leaving. Select a reason from the list:

    * Too expensive
    * Not using it enough
    * Missing features I need
    * Found an alternative
    * Technical issues
    * Just pausing temporarily
    * Other (with a text field for details)
  </Step>

  <Step title="Confirm cancellation">
    Click "Submit & Cancel Plan" to finalize the cancellation.
  </Step>
</Steps>

<Warning>
  Cancellation does not take effect immediately. Your paid plan features remain active until the end of your current billing period. After that, your account reverts to the Free plan.
</Warning>

## What Happens After Cancellation

When your subscription ends at the end of the billing period:

* Your plan changes to **Free**
* AI credits are reset to **250** (the Free plan allocation)
* Published pages remain live on Shopify, but you cannot publish new pages or update existing ones
* You can still access the builder and edit pages, but publishing requires re-subscribing
* Your data (pages, brand styles, assets) is preserved

## Payment Status Tracking

Your subscription can be in one of several payment states:

| Status             | Description                                                            |
| ------------------ | ---------------------------------------------------------------------- |
| **Active**         | Subscription is current and all features are available                 |
| **Payment failed** | Payment has failed. Action is required to continue using paid features |

### Payment Failed Popup

If your payment fails, a **Payment Failed** popup appears immediately. This popup:

* Informs you that your payment could not be processed
* Provides a direct link to update your payment method via the billing portal
* You must resolve the payment issue before continuing to use the builder

## Pending Plan Changes

When you schedule a downgrade (e.g., from Pro to Starter, or from any paid plan to Free):

* The change is **scheduled** for the end of your current billing period
* A "Scheduled" indicator appears on the pending plan in the pricing modal
* Your current plan button changes to "Keep {Plan}" with the option to cancel the downgrade
* If you change your mind, click "Keep {Plan}" to cancel the scheduled downgrade and stay on your current plan

## Subscription Tips

<AccordionGroup>
  <Accordion title="Keep your payment method current">
    Ensure your credit card on file has not expired. Failed payments can temporarily restrict your access to paid features.
  </Accordion>

  <Accordion title="Review your usage before downgrading">
    Before downgrading, check how many pages you have published and how many AI credits you typically use. Downgrading may affect active published pages.
  </Accordion>

  <Accordion title="Upgrade anytime">
    Upgrades take effect immediately with prorated billing. You do not need to wait for a new billing cycle.
  </Accordion>
</AccordionGroup>