From b30dda3eda79955f1b0f3707b58ae7ed16d8bbab Mon Sep 17 00:00:00 2001 From: Shahed Nasser Date: Mon, 3 Nov 2025 17:20:59 +0200 Subject: [PATCH] docs: fix broken image in billing docs + clarify billing details (#13944) --- www/apps/cloud/app/billing/page.mdx | 10 +++++----- www/apps/cloud/app/environments/preview/page.mdx | 6 ++++-- www/apps/cloud/app/usage/page.mdx | 6 ++++-- www/apps/cloud/generated/edit-dates.mjs | 6 +++--- 4 files changed, 16 insertions(+), 12 deletions(-) diff --git a/www/apps/cloud/app/billing/page.mdx b/www/apps/cloud/app/billing/page.mdx index 28c3dcec72..096da03fc7 100644 --- a/www/apps/cloud/app/billing/page.mdx +++ b/www/apps/cloud/app/billing/page.mdx @@ -11,13 +11,13 @@ In this guide, you'll learn how billing works in Cloud, and how to view and down ## How Billing Works -Medusa bills your organization monthly. +Medusa bills your organization monthly based on its plan and usage across projects. If you're in multiple organizations, each organization is billed separately. -Your monthly invoice contains: +Your organization's monthly invoice contains: - An upfront charge for the plan you are currently on. -- An upfront charge for the add-ons you have. -- Pro-rated charges for the add-ons you added in the previous billing cycle. +- An upfront charge for the [add-ons](#purchase-add-on-resources) you have. +- Pro-rated charges for the [add-ons](#purchase-add-on-resources) you added in the previous billing cycle. - Charges for your [Flex Usage](../usage/page.mdx#what-is-flex-usage) in the previous billing cycle. If your organization goes over its plan's usage limits within the current billing period, charges for your [Flex Usage](../usage/page.mdx#what-is-flex-usage) will be added to your next invoice. @@ -73,7 +73,7 @@ To download a receipt for a specific payment: This will open the receipt in a new tab, where you can view and download it as a PDF. -![Download receipt icon in the Invoices settings](https://res.cloudinary.com/dza7lstvk/image/upload/v1750242600/Cloud/CleanShot_2025-06-18_at_13.30.03_2x_wwm3yo.png) +![Download receipt icon in the Invoices settings](https://res.cloudinary.com/dza7lstvk/image/upload/v1750242445/Cloud/CleanShot_2025-06-18_at_13.27.05_2x_qqibor.png) --- diff --git a/www/apps/cloud/app/environments/preview/page.mdx b/www/apps/cloud/app/environments/preview/page.mdx index a5a6f2a038..65bf0b4d9f 100644 --- a/www/apps/cloud/app/environments/preview/page.mdx +++ b/www/apps/cloud/app/environments/preview/page.mdx @@ -51,7 +51,9 @@ You can also view the preview deployment and its status in the comment made on y ## Increase Preview Environment Limits -Based on your [plan](../../pricing/page.mdx), you may have limits on the number of active preview environments you can have at a time. For example, if your plan allows for one active preview environment, you can only have one open PR with a preview environment at a time. +Based on your [plan](../../pricing/page.mdx), you may have limits on the number of active preview environments you can have at a time across all projects in your organization. + +For example, if your plan allows for one active preview environment, you can only have one open PR with a preview environment at a time. If you open a second PR in any project, the preview environment for that PR will fail to deploy. You can increase this limit either from the [Billing](../../billing/manage/page.mdx#change-concurrent-previews-limit) settings or on the project dashboard. @@ -62,7 +64,7 @@ To increase the concurrent previews limit from the project dashboard: 3. In the pop-up that opens, you can see how much it would cost to increase the limit. 4. Click the "Increase limit and deploy preview" button to confirm. -This will increase the concurrent previews limit for your organization, and you can view your updated bill in the [Invoices](../../billing/page.mdx#view-billing-history-and-invoices) settings. +This will increase the concurrent previews limit across projects in your organization, and you can view your updated bill in the [Invoices](../../billing/page.mdx#view-billing-history-and-invoices) settings. ![Provision preview environments pop-up in the project dashboard](https://res.cloudinary.com/dza7lstvk/image/upload/v1759410384/Cloud/CleanShot_2025-10-02_at_16.04.33_2x_z5zpw6.png) diff --git a/www/apps/cloud/app/usage/page.mdx b/www/apps/cloud/app/usage/page.mdx index c4cfa030ee..2f46339da5 100644 --- a/www/apps/cloud/app/usage/page.mdx +++ b/www/apps/cloud/app/usage/page.mdx @@ -11,7 +11,7 @@ In this guide, you'll learn how to monitor your Cloud organization's standard an ## View Usage on Cloud -In your organization's settings, you can view your current plan and usage limits. +In your organization's settings, you can view your current plan and usage limits. These usage limits depend on the plan your organization is on, and are applied across all projects within the organization. @@ -34,7 +34,9 @@ In the Usage settings, you'll find a table with the list of resources your organ ## What is Flex Usage? -Usage that exceeds the limits of your plan is considered Flex Usage. For example, if your plan allows for 100GB data transfer, any usage beyond that limit would be classified as Flex Usage. +Your organization has a set of usage limits based on its current [plan](../pricing/page.mdx). These usage limits are applied across all projects within the organization. + +Usage that exceeds the limits of your plan is considered Flex Usage. For example, if your plan allows for 100GB data transfer, any usage beyond that limit would be classified as Flex Usage. To learn how your Flex Usage is billed, refer to the [Billing](../billing/page.mdx) guide. diff --git a/www/apps/cloud/generated/edit-dates.mjs b/www/apps/cloud/generated/edit-dates.mjs index 92ea44d443..29742126b6 100644 --- a/www/apps/cloud/generated/edit-dates.mjs +++ b/www/apps/cloud/generated/edit-dates.mjs @@ -15,10 +15,10 @@ export const generatedEditDates = { "app/connect-storefront/page.mdx": "2025-06-25T07:47:00.499Z", "app/environments/environment-variables/page.mdx": "2025-10-15T15:26:47.364Z", "app/environments/long-lived/page.mdx": "2025-10-15T15:27:08.743Z", - "app/environments/preview/page.mdx": "2025-10-15T15:19:02.671Z", + "app/environments/preview/page.mdx": "2025-11-03T12:50:29.841Z", "app/faq/page.mdx": "2025-10-08T14:43:21.930Z", - "app/billing/page.mdx": "2025-10-08T14:37:11.611Z", - "app/usage/page.mdx": "2025-10-15T15:26:16.696Z", + "app/billing/page.mdx": "2025-11-03T13:16:46.330Z", + "app/usage/page.mdx": "2025-11-03T12:45:13.760Z", "app/billing/manage/page.mdx": "2025-10-08T14:40:23.629Z", "app/pricing/page.mdx": "2025-09-05T10:31:59.059Z", "app/sign-up/page.mdx": "2025-10-08T14:40:47.993Z",