--- title: "Billing" description: "How to manage repository plans, payments, billing details, and invoices." category: "manage-prismic" lastUpdated: "2026-01-14T15:26:55.000Z" --- Prismic billing works on a **per repository** basis, not per account. Your account will always be free, and you pay only for the individual repositories you upgrade. Repository owners and administrators can change billing and payment details as well as view subscriptions and invoices. > **Important** > > Complete your repository billing information as soon as you upgrade. Invoices are final once issued, so make sure all details are correct. # Plans and pricing Each repository can be on a different plan. Plans vary by team size, features, and API/CDN usage. To compare plans: 1. Go to **Settings → Plans & Billing**. 2. Review plan options and pricing. 3. Pick the plan best suited to your project by clicking on **update plan**. You can switch between **monthly** and **yearly** billing at any time. > Annual billing includes a discount. See the [pricing page](https://prismic.io/pricing) for full details. ## Upgrade your plan 1. Go to **Settings → Plans & Billing**. 2. Click **Upgrade plan**. 3. Choose a tier and billing cycle. Upgrades take effect immediately. > **Important** > > When a repository exceeds its usage plan limits, it will automatically upgrade to the next plan tier that supports its current usage to prevent any service disruptions. > > More information: [Automatic Upgrades](#automatic-upgrades). ## Downgrade your plan 1. Go to **Settings → Plans & Billing**. 2. Click **Change plan**. 3. Select a lower plan or **Free**. 4. Review the limits for the selected plan and confirm. Changing your plan does not remove charges for usage already incurred. Unless you pick otherwise, any changes in plans such as upgrades or downgrades will keep your current billing cycle's type (monthly-to-monthly or yearly-to-yearly). You can downgrade your plan only if your current usage is within the limits of the plan you want to switch to. This includes API/CDN usage, user count, and locale count. For example, if your repository has 4 locales on the Small plan and you want to downgrade to the Free plan, you must first reduce your locale count to 2 or fewer before downgrading. API and CDN usage reset at the start of each monthly billing cycle. If your usage exceeds the limits of the plan you want to downgrade to, you'll need to optimize your usage and wait until your next billing cycle begins. Once your usage resets and is below the target plan's limits, you'll be able to downgrade. > **Important** > > Usage limits are evaluated at the time you request the downgrade. If your usage is above the limits of the selected plan for the month, the downgrade won't be available until your usage resets. More on how to check your usage: [Usage Dashboard](#usage-dashboard). # Payment methods All plans can be paid by **credit card**. Annual **Platinum+** and **Enterprise** plans can also be settled by **bank transfer** on request. To manage payment details: 1. Go to **Settings → Plans & Billing → Payment** (bottom of the page). 2. Click **Manage** to open the Stripe-hosted payment portal. In the payment portal, you can: * Add or update a card. * Change billing information (name, address, tax ID, etc.). * Switch payment methods. * View past invoices. # Automatic Upgrades When a repository exceeds its monthly **API Call** or **Bandwidth** limits, it automatically upgrades to the next plan tier that supports its current usage. This ensures your service continues without interruption. Automatic upgrades occur when a repository reaches the maximum usage threshold for its current plan: * **Bandwidth** * Paid overages are allowed up to the plan's limit. * Automatically upgrades once the limit is exceeded. * **API Calls** * Does not have overages. * Automatically upgrades once the limit is reached. The new plan takes effect immediately, and billing adjusts from that point onward. Upgrades remain within the same billing cycle (e.g., monthly to monthly or yearly to yearly). Prismic notifies you in the dashboard when usage is nearing or exceeds your plan limits. You can also monitor your repository's usage in real time under **Settings → [Usage Dashboard](#usage-dashboard)**. Free plans don't allow overages. If usage exceeds the plan's limits, the repository will be locked until usage is reduced or a paid plan is selected. For full details on plan limits, visit the [Pricing page](https://prismic.io/pricing). # Usage dashboard The usage dashboard, located in **Settings → Usage Dashboard** in your repository, tracks how your repository is consuming resources during the **current billing period**. It helps you visualize current usage, identify trends, and check how close you are to your plan limits. * **API requests**: The total number of requests made to your repository’s API. * **CDN bandwidth**: The amount of data served from the Prismic CDN. * **Integration fields**: The number of requests made through integration fields. A color-coded status indicator next to each metric shows how close you are to your plan limits. ## Filter usage by date The date filter lets you focus on a specific period within the current billing cycle. This can help identify short-term usage spikes or compare different periods. ## Download usage logs Download a CSV file with detailed usage logs. The logs include: * **Timestamp** — When the request or bandwidth usage was recorded. * **Type** — API request, CDN bandwidth, or integration field. * **Quantity** — The number of requests or the volume of data used. * **Source** — Where the request came from (e.g., API endpoint, integration). * **Referrer** — The URL or service that made the request. Use this data to: * Pinpoint high-traffic times. * See which integration fields or endpoints are consuming the most resources. * Share exact usage data with your technical team for deeper analysis. ## Usage data updates Usage updates periodically, not in real time. This means recent activity might take up to 24 hours to appear in the dashboard or logs. > Historical data and additional charts may be available in the future as the dashboard evolves. # Invoices Invoices are available in the **Payment** section of **Plans & Billing**. Each invoice shows: * Plan and billing period. * Any API or CDN overages (billed per call/GB). * Tax information. > **Important** > > Invoices can’t be modified after they’re issued, so make sure your billing information is up-to-date before your next payment. All invoices are available on the portal: we cannot send you past invoices. # Keeping billing up to date Prismic will continue servicing your project as long as your payment method is valid and your plan is active. If your payment method needs updating: * Go to **Plans & Billing → Payment**. * Click **Manage billing** to update card details. * Save changes. If your payment isn't processed or fails for any reason, the system will retry automatically up to three times. # Refunds Annual plan renewals can be refunded if requested within **30 days** of the renewal date. Monthly plans are not eligible for refunds. To request a refund: 1. Downgrade the repository to the **Free** plan. 2. Contact [support](https://prismic.io/docs/help-center.md#support) with your repository name and billing information. Refund processing can take several weeks.