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

# Upgrading Your Plan

> Learn how to upgrade your EcomWize Builder plan, understand prorating, and get immediate access to new features.

Upgrading your plan unlocks higher limits, more AI credits, and advanced features instantly. EcomWize makes upgrading seamless with mid-cycle prorating and immediate feature access.

## When You Will See Upgrade Prompts

EcomWize shows upgrade prompts in context when you hit a plan limit:

* **Publishing limit** -- When you try to publish a page and have reached your published page limit (Starter plan: 10 pages).
* **Store limit** -- When you try to connect a second store on the Free or Starter plan.
* **AI credits depleted** -- When you attempt an AI operation with insufficient credits.
* **Feature restrictions** -- When you try to use a Pro-only feature like Shopify Markets or Shopify-editable mode.

These prompts include a direct link to the pricing modal so you can upgrade without navigating away from your work.

## How to Upgrade

### From the Pricing Modal

<Steps>
  <Step title="Open the pricing modal">
    Click on your plan indicator in the sidebar, or click "Upgrade" from any limit prompt. The full-screen pricing modal slides up.
  </Step>

  <Step title="Compare plans">
    Review the three plan tiers (Free, Starter, Pro) with their features and pricing. Your current plan is indicated with a "Current Plan" button.
  </Step>

  <Step title="Select your new plan">
    Click "Switch to {Plan}" on the plan you want to upgrade to.
  </Step>

  <Step title="Complete payment">
    For new subscriptions (Free to paid), you are redirected to a secure checkout page to enter your payment details. For plan changes between paid tiers, a confirmation dialog appears with prorating details.
  </Step>
</Steps>

## Upgrade Paths

### Free to Starter (\$49/mo)

* Redirects to a secure checkout page for initial payment setup
* After payment, your plan activates immediately
* AI credits are set to 1,000
* You can start publishing pages right away

### Free to Pro (\$79/mo)

* Redirects to a secure checkout page for initial payment setup
* After payment, your plan activates immediately
* AI credits are set to 5,000
* All Pro features are unlocked instantly

### Starter to Pro (\$79/mo)

* A confirmation dialog shows the prorated amount due today
* The prorated charge covers the difference for the remainder of your billing cycle
* After confirmation, the upgrade applies immediately
* AI credits are reset to 5,000

## Understanding Prorating

When you upgrade between paid plans mid-cycle, EcomWize calculates a prorated charge so you only pay the difference for the remaining days in your billing period.

**Example:** If you upgrade from Starter ($49/mo) to Pro ($79/mo) halfway through your billing cycle:

* You have already paid \$49 for the full month
* The Pro plan costs \$79 for a full month
* The difference is \$30 for a full month
* Since you are halfway through, the prorated charge is approximately \$15

The exact prorated amount is shown in the confirmation dialog before you confirm the upgrade. Your next full billing cycle will charge the full Pro plan price.

## What Happens After Upgrading

When your upgrade is confirmed:

| Aspect                | What Happens                                               |
| --------------------- | ---------------------------------------------------------- |
| **Features**          | All new plan features are available immediately            |
| **AI credits**        | Reset to the new plan's full allocation                    |
| **Publishing limits** | Updated to the new plan's limits instantly                 |
| **Store connections** | New limits apply immediately (Pro: unlimited)              |
| **Billing cycle**     | Continues on your existing billing date                    |
| **Prorated charge**   | Charged immediately for the remainder of the current cycle |

<Note>
  Your page data, brand styles, sections, and all other content are preserved during the upgrade. Nothing is lost or reset except AI credits, which are set to the new plan's allocation.
</Note>

## Upgrade Confirmation Dialog

When upgrading between paid plans, a confirmation dialog provides:

* **Source and target plan names** -- Shows which plan you are upgrading from and to
* **Features you will unlock** -- A checklist of new features available on the higher plan
* **Prorated amount** -- The exact charge for the remainder of your billing cycle (may show a loading skeleton while being calculated)
* **Confirm/Cancel buttons** -- To proceed or go back

<Warning>
  Once confirmed, upgrades are processed immediately and the prorated charge is applied to your payment method on file. Make sure your payment method is current before upgrading.
</Warning>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Can I upgrade in the middle of a billing cycle?">
    Yes. Upgrades take effect immediately with a prorated charge for the remaining days in your current cycle.
  </Accordion>

  <Accordion title="Will I lose any data when upgrading?">
    No. All your pages, brand styles, sections, and assets are preserved. Only your AI credits and plan limits change.
  </Accordion>

  <Accordion title="What if my payment fails during upgrade?">
    If the payment cannot be processed, the upgrade does not go through and your current plan remains active. Check your payment method and try again.
  </Accordion>

  <Accordion title="Can I downgrade after upgrading?">
    Yes. You can switch to a lower plan at any time. Downgrades are scheduled for the end of your current billing period so you keep your paid features until then.
  </Accordion>
</AccordionGroup>