Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion claude-plugins/inki/references/authoring/AGENTS.cloud.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Technical writing rules
Content specifics
- Emphasize deployment, security, IAM, and operational runbooks.
- For provider steps (e.g., AWS), keep screenshots current and add troubleshooting.
- For Cloud plan availability, use the Cloud plan badges (`CloudEssentialBadge`, `CloudProBadge`, `CloudScaleBadge`); see `../../templates/components/badge.md`. There is no `FreeBadge`: the Free plan is shown by the absence of any badge.
- For Cloud plan availability, use the Cloud plan badges (`CloudEssentialBadge`, `CloudProBadge`, `CloudScaleBadge`); see `../../templates/components/badge.md`. There is no `FreeBadge`: if no badge is shown, the feature is available on the Essential plan.

Preflight checks before PR
- Run generators; ensure anchors present; verify file paths for code snippets.
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Use a Badge to flag the availability or status of a feature next to a heading or
## When NOT to use

- Do not use the raw default `<Badge>` element. It is not registered as a global MDX component (only the named alias functions are), so a bare `<Badge variant="..." />` will not resolve and the page will fail to build.
- Do not invent variants that do not exist. There is no `FreeBadge` and no `CloudDevBadge`. The Strapi Cloud Free plan is represented by the absence of any badge: if no badge is shown, the feature is available on the Free plan.
- Do not invent variants that do not exist. There is no `FreeBadge` and no `CloudDevBadge`. If no Cloud plan badge is shown, the feature is available on the Essential plan.
- Do not place a badge where its tooltip would be cut off, or where the default tooltip is wrong without overriding it via the `tooltip` prop.
- Do not use a badge in a context that needs plain text, such as inside a code block.

Expand Down
6 changes: 3 additions & 3 deletions docusaurus/docs/cloud/advanced/upload-size-limits.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Strapi Cloud applies 2 distinct limits to uploads. The first is a hard maximum f

## Maximum upload file size for non-image files

Non-image uploads are capped at 200 MB on all Strapi Cloud plans (Free, Essential, Pro, and Scale). The cap is enforced at the infrastructure level and cannot be overridden via the `strapi::body` middleware configuration.
Non-image uploads are capped at 200 MB on all Strapi Cloud plans. The cap is enforced at the infrastructure level and cannot be overridden via the `strapi::body` middleware configuration.

## Recommended maximum upload size for image files

Expand All @@ -48,7 +48,7 @@ Recommended maximum image size, expressed in megapixels (MP), per format and pla
<Tabs groupId="processing">
<TabItem value="on" label="Processing on">

| Format | Free & Essential | Pro & Scale |
| Format | Essential | Pro & Scale |
|--------|------------------|-------------|
| JPEG | 24 MP | 135 MP |
| PNG | 8 MP | 90 MP |
Expand All @@ -59,7 +59,7 @@ Recommended maximum image size, expressed in megapixels (MP), per format and pla
</TabItem>
<TabItem value="off" label="Processing off">

| Format | Free & Essential | Pro & Scale |
| Format | Essential | Pro & Scale |
|--------|------------------|-------------|
| JPEG | 200 MP | 265 MP |
| PNG | 20 MP | 115 MP |
Expand Down
6 changes: 3 additions & 3 deletions docusaurus/docs/cloud/getting-started/cloud-fundamentals.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ tags:

<Tldr>

Strapi Cloud is a PaaS hosting platform for deploying Strapi CMS projects, offering four pricing plans with different features and support levels, two user roles (owners and maintainers), and REST/GraphQL APIs that behave identically to self-hosted servers.
Strapi Cloud is a PaaS hosting platform for deploying Strapi CMS projects, offering three pricing plans with different features and support levels, two user roles (owners and maintainers), and REST/GraphQL APIs that behave identically to self-hosted servers.

</Tldr>

Expand All @@ -21,11 +21,11 @@ Before going any further into this Strapi Cloud documentation, we recommend you

- **Hosting Platform** <br/> Strapi Cloud is a hosting platform that allows to deploy already existing Strapi projects created with Strapi CMS (Content Management System). Strapi Cloud is *not* the SaaS (<ExternalLink to="https://en.wikipedia.org/wiki/Software_as_a_service" text="Software-as-a-Service" />) version of Strapi CMS and should rather be considered as a PaaS (<ExternalLink to="https://en.wikipedia.org/wiki/Platform_as_a_service" text="Platform-as-a-Service" />). Feel free to refer to the [CMS documentation](https://docs.strapi.io/cms/intro) to learn more about Strapi CMS.

- **Strapi Cloud Pricing Plans** <br/> As a Strapi Cloud user you have the choice between 4 plans: Free, Essential, Pro and Scale. Depending on the plan, you have access to different functionalities, support and customization options (see [Pricing page](https://strapi.io/pricing-cloud) for more details). In this Strapi Cloud documentation, the <CloudEssentialBadge />, <CloudProBadge />, and <CloudScaleBadge /> badges can be displayed below a section's title to indicate that the feature is only available starting from the corresponding paid plan. If no badge is shown, the feature is available on the Free plan.
- **Strapi Cloud Pricing Plans** <br/> As a Strapi Cloud user you have the choice between 3 plans: Essential, Pro, and Scale. Depending on the plan, you have access to different functionalities, support and customization options (see [Pricing page](https://strapi.io/pricing-cloud) for more details). In this Strapi Cloud documentation, the <CloudProBadge /> and <CloudScaleBadge /> badges can be displayed below a section's title to indicate that the feature is only available starting from the corresponding plan. If no badge is shown, the feature is available on the Essential plan. Only Pro and Scale badges are used in Cloud docs because Essential is the baseline plan; the <CloudEssentialBadge /> component exists for consistency with other Strapi documentation but is not displayed on Cloud pages.

- **Types of Strapi Cloud users** <br/> There can be 2 types of users on a Strapi Cloud project: owners and maintainers. The owner is the one who has created the project and has therefore access to all features and options for the project. Maintainers are users who have been invited to contribute to an already created project by its owner. Maintainers, as documented in the [Collaboration](/cloud/projects/collaboration) page, cannot view and access all features and options from the Strapi Cloud dashboard.

- **Support** <br/> The level of support provided by the Strapi Support team depends on the Strapi Cloud plan you subscribed for. The Free plan does not include access to support. The Essential and Pro plans include Basic support while the Scale plan includes Standard support. Please refer to the [dedicated support article](https://support.strapi.io/support/solutions/articles/67000680833-what-is-supported-by-the-strapi-team#Not-Supported) for all details regarding support levels.
- **Support** <br/> The level of support provided by the Strapi Support team depends on the Strapi Cloud plan you subscribed for. The Essential and Pro plans include Basic support while the Scale plan includes Standard support. Please refer to the [dedicated support article](https://support.strapi.io/support/solutions/articles/67000680833-what-is-supported-by-the-strapi-team#Not-Supported) for all details regarding support levels.

- **API access in Strapi Cloud vs self-hosted** <br/> The REST and GraphQL APIs behave the same on Strapi Cloud and on self-hosted servers. The only differences are the URLs:
- Base API domain: On Strapi Cloud, your API uses the domain of the environment (e.g. `https://<project>.strapiapp.com/api/...`), or your custom domain if you set one (see [Domains documentation](/cloud/projects/settings#domains)). A self-hosted project would use whatever domain you expose.
Expand Down
11 changes: 0 additions & 11 deletions docusaurus/docs/cloud/getting-started/deployment.md
Original file line number Diff line number Diff line change
Expand Up @@ -111,10 +111,6 @@ Before you can deploy your Strapi application on Strapi Cloud using the Cloud da
:::tip
Connect the GitHub or GitLab account that owns the repository you want to deploy. This can be different from the account you used to log into your Strapi Cloud account.
:::
:::note

You can only connect a GitHub organization repository on a paid plans. On the free plan, you can only connect a personal repository.
:::

4.a. If you have already given Strapi Cloud access to all repositories of your GitHub or GitLab account, go directly to the next step. If not, you will be redirected to a modal where you will have to allow Strapi Cloud permission to access some or all your repositories on GitHub/GitLab (more information in the <ExternalLink to="https://docs.github.com/en/apps/overview" text="GitHub"/> and <ExternalLink to="https://docs.gitlab.com/ee/integration/oauth_provider.html#view-all-authorized-applications" text="GitLab"/> documentation).

Expand Down Expand Up @@ -171,15 +167,8 @@ Before you can deploy your Strapi application on Strapi Cloud using the Cloud da

## Setting up billing details

:::strapi No billing step for the Free plan
If you chose the free plan, this billing step will be skipped as you will not be asked to share your credit card details at the creation of the project.

<Icon name="fast-forward" /> Skip to step 5 of the section below to finalize the creation of your project.
:::

1. Click on the **Continue to billing** button. You will be redirected to the billing page where you can enter your payment details and review your invoice.


<ThemedImage
alt="Payment & Billing"
sources={{
Expand Down
62 changes: 16 additions & 46 deletions docusaurus/docs/cloud/getting-started/usage-billing.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,26 +15,26 @@ tags:

<Tldr>

Strapi Cloud offers four plans (Free, Essential, Pro, Scale) with usage-based pricing that varies by API requests, asset storage, and bandwidth, plus overages charged monthly; projects may be suspended for unpaid invoices or plan violations.
Strapi Cloud offers three plans (Essential, Pro, and Scale) with usage-based pricing that varies by API requests, asset storage, and bandwidth, plus overages charged monthly; projects may be suspended for unpaid invoices or plan violations.

</Tldr>


This page contains general information related to the usage and billing of your Strapi Cloud account and projects.

Strapi Cloud offers 1 Free plan and 3 paid plans: Essential, Pro and Scale (see [Pricing page](https://strapi.io/pricing-cloud)). The table below summarizes Strapi Cloud usage-based pricing plans, for general features and usage:
Strapi Cloud offers 3 plans: Essential, Pro, and Scale (see [Pricing page](https://strapi.io/pricing-cloud)). The table below summarizes Strapi Cloud usage-based pricing plans, for general features and usage:

| Feature | Free | Essential | Pro | Scale |
| -------------------------------- | ----- | --------- | --- | ----- |
| **Database Entries** | 500 | Unlimited* | Unlimited* | Unlimited* |
| **Asset Storage** | 10GB | 50GB | 250GB | 1,000GB |
| **Asset Bandwidth (per month)** | 10GB | 50GB | 500GB | 1,000GB |
| **API Requests (per month)** | 2,500 | 50,000 | 1,000,000 | 10,000,000 |
| | | | | |
| **Backups** | N/A | N/A | Weekly | Daily |
| **Custom domains** | N/A | Included | Included | Included |
| **Environments** | N/A | N/A | 0 included (up to 99 extra) | 1 included (up to 99 extra) |
| **Emails (per month)** | 100 | Unlimited* | Unlimited* | Unlimited* |
| Feature | Essential | Pro | Scale |
| -------------------------------- | --------- | --- | ----- |
| **Database Entries** | Unlimited* | Unlimited* | Unlimited* |
| **Asset Storage** | 50GB | 250GB | 1,000GB |
| **Asset Bandwidth (per month)** | 50GB | 500GB | 1,000GB |
| **API Requests (per month)** | 50,000 | 1,000,000 | 10,000,000 |
| | | | |
| **Backups** | N/A | Weekly | Daily |
| **Custom domains** | Included | Included | Included |
| **Environments** | N/A | 0 included (up to 99 extra) | 1 included (up to 99 extra) |
| **Emails (per month)** | Unlimited* | Unlimited* | Unlimited* |

:::strapi Additional information on usage and features
- General features & usage:
Expand All @@ -48,20 +48,6 @@ Strapi Cloud offers 1 Free plan and 3 paid plans: Essential, Pro and Scale (see
- Environments refers to the number of environments included in the plan on top of the default production environment (see [Environments](/cloud/projects/settings#environments) documentation for more information on the feature).
:::

:::caution The Free Plan is for personal, non-commercial use only
Commercial use means any project made for financial gain, including:
- Accepting or processing payments on your site
- Accepting or receiving payment to create, update, or host the site
- Advertising, promoting, or selling products or services
- Hosting or serving advertisements for any 3rd party
For more information, visit [Strapi Cloud-Legal](https://strapi.io/cloud-legal)
:::

:::info Scale-to-zero and cold start on the Free plan
On the Free plan, projects automatically scale down to zero after a short period of inactivity. When the application is accessed again—either through the frontend or via an API request—it may take a few seconds (up to a minute) before a response is returned.
Upgrading to a paid plan disables scaling to zero and cold starts, resulting in instant response times at all times.
:::

## Environments management

Environments are isolated instances of your Strapi Cloud project. All projects have a default production environment, but other additional environments can be configured for projects on a Pro or Scale plan, from the *Environments* tab of the project settings (see [Environments](/cloud/projects/settings#environments)). There is no limit to the number of additional environments that can be configured for a Strapi Cloud project.
Expand All @@ -80,10 +66,6 @@ You can add or update your VAT/Tax ID from your [Account Billing](/cloud/account

### Overages

:::caution
Overages are not allowed on the Free plan.
:::

If you exceed the limits of your plan for API Requests, Asset Bandwidth, or Asset Storage, you will be charged for the corresponding overages.

For example, if you exceed the 500GB limit in asset bandwidth of the Pro plan, you will be charged for the excess bandwidth at the end of the current billing period or on project deletion. Overages are not prorated and are charged in full.
Expand All @@ -98,22 +80,10 @@ Overages are charged monthly, according to the following rates:

### Project suspension

Projects may end up in a **Suspended** state for various reasons, including: unpaid invoices, exceeding the limits of your free plan, or violating Strapi Cloud's <ExternalLink to="https://strapi.io/cloud-legal" text="terms of service"/>.
Projects may end up in a **Suspended** state for various reasons, including unpaid invoices or violating Strapi Cloud's <ExternalLink to="https://strapi.io/cloud-legal" text="terms of service"/>.

If your project is suspended, you will no longer be able to access the Strapi admin panel, nor trigger new deployments. A banner will appear in your project's dashboard, indicating the cause of the suspension. You will also be notified by email.

#### Project suspension for exceeding the Free plan limits

When a project hosted with the Free plan exceeds either the API requests or the Asset Bandwidth limits, it will be suspended until the monthly allowance resets at the beginning of the following month.

While the project is suspended:

- Users cannot trigger new deployments
- Access to the application is blocked
- Users cannot make changes to the project’s settings

To reactivate the project immediately, users can upgrade to a paid plan.

#### Project suspension due to billing issues

If you have unpaid invoices, the subscription of your project will automatically be canceled and the project suspended.
Expand Down Expand Up @@ -144,5 +114,5 @@ If your project was suspended for reasons other than unpaid invoice leading to s

If you want to cancel your Strapi Cloud subscription, you have 2 options:

- either change your project's subscription to the free plan (see [Downgrading to another plan](/cloud/projects/settings#downgrading-to-another-plan) documentation),
- or completely delete your project (see [Deleting Strapi Cloud project](/cloud/projects/settings#deleting-a-strapi-cloud-project) documentation).
- either delete your project (see [Deleting Strapi Cloud project](/cloud/projects/settings#deleting-a-strapi-cloud-project) documentation),
- or completely delete your account (see [Deleting Strapi Cloud account](/cloud/account/account-settings#deleting-strapi-cloud-account) documentation).
12 changes: 3 additions & 9 deletions docusaurus/docs/cloud/projects/settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -116,7 +116,7 @@ The ownership of the Strapi Cloud project can be transferred to another user, as

:::prerequisites
For the ownership of a project to be transferred, the following requirements must be met:
- The project must be on a paid plan, with no currently expired card and/or unpaid bills.
- The project must not currently have expired card and/or unpaid bills.
- The maintainer must have filled their billing information.
- No already existing ownership transfer must be pending for the project.

Expand Down Expand Up @@ -253,8 +253,6 @@ Plan downgrades can be managed, for each project, via the project settings. Down
Make sure to check the usage of your Strapi Cloud project before downgrading: if your current usage exceeds the limits of the lower plan, you are taking the risk of getting charged for overages. You may also lose access to some features: for example, downgrading to the Essential plan would result in the loss of all your project's backups. Please refer to [Information on billing & usage](/cloud/getting-started/usage-billing) for more information.

Note also that you cannot downgrade if you have additional paid environments. You will first need to delete all additional environments that were not included in the base price of your plan (see [Clearing and deleting environments](#resetting--deleting-environment)) before you can schedule a downgrade. When downgrading from Scale to Pro, the additional included environment will automatically be deleted when the downgrade takes effect.

You cannot downgrade to the Free plan if a GitHub organization repository is connected to the project. To downgrade, first switch to a personal repository in the [Connected Git repository](#modifying-git-repository--branch) settings.
:::

To downgrade your current plan to a lower one:
Expand Down Expand Up @@ -284,7 +282,7 @@ When switching from yearly to monthly billing, your plan will remain on its year

### Invoices

The <Icon name="invoice" /> *Invoices* tab displays the full list of invoices for your Strapi Cloud project as well as their status. No invoice is issued for the Free plan.
The <Icon name="invoice" /> *Invoices* tab displays the full list of invoices for your Strapi Cloud project as well as their status.


<ThemedImage
Expand Down Expand Up @@ -425,7 +423,7 @@ The <Icon name="arrow-clockwise" /> *Backups* tab informs you of the status and

:::note Notes

- The backup feature is not available for Strapi Cloud projects on the Free or Essential plans. You will need to upgrade to the Pro or Scale plan to enable automatic backups and access the manual backup option.
- The backup feature is not available for Strapi Cloud projects on the Essential plan. You will need to upgrade to the Pro or Scale plan to enable automatic backups and access the manual backup option.

- Backups include only the database of your default Production environment. Assets uploaded to your project and databases from any secondary environments are not included.

Expand Down Expand Up @@ -503,10 +501,6 @@ All existing domains for your Strapi Cloud project are listed in the <Icon name=

Default domain names are made of 2 randomly generated words followed by a hash. They can be replaced by any custom domain of your choice.

:::note
Custom domains are not available on the Free plan. Downgrading to the Free plan will result in the application domain's being restored to the default one.
:::

1. Click the **Connect new domain** button.
2. In the window that opens, fill in the following fields:

Expand Down
Loading
Loading