From 04bd263acfac66bf1f33eacff7bc48a2b1a4bd03 Mon Sep 17 00:00:00 2001
From: Thomas <31189692+ecktoteckto@users.noreply.github.com>
Date: Sat, 8 Feb 2025 13:50:12 +0100
Subject: [PATCH] docs(billing) - revamp custom domain usage

---
 .../NavigationMenu.constants.ts               |  4 ++
 .../guides/platform/manage-your-usage.mdx     |  3 +-
 .../manage-your-usage/custom-domains.mdx      | 62 +++++++++++++++++++
 3 files changed, 68 insertions(+), 1 deletion(-)
 create mode 100644 apps/docs/content/guides/platform/manage-your-usage/custom-domains.mdx

diff --git a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
index 1c1a7666dea..48a102d3930 100644
--- a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
+++ b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
@@ -2135,6 +2135,10 @@ export const platform: NavMenuConstant = {
               name: 'IPv4',
               url: '/guides/platform/manage-your-usage/ipv4',
             },
+            {
+              name: 'Custom Domains',
+              url: '/guides/platform/manage-your-usage/custom-domains',
+            },
           ],
         },
         {
diff --git a/apps/docs/content/guides/platform/manage-your-usage.mdx b/apps/docs/content/guides/platform/manage-your-usage.mdx
index 76dbe8d56b9..03b99413dfd 100644
--- a/apps/docs/content/guides/platform/manage-your-usage.mdx
+++ b/apps/docs/content/guides/platform/manage-your-usage.mdx
@@ -12,4 +12,5 @@ Each subpage breaks down a specific usage item and details what you're charged f
 - [Storage Size](/docs/guides/platform/manage-your-usage/storage-size)
 - [Disk Size](/docs/guides/platform/manage-your-usage/disk-size)
 - [Edge Function Invocations](/docs/guides/platform/manage-your-usage/edge-function-invocations)
-- [IPv4](/docs/guides/platform/manage-your-usage/ipv4)
\ No newline at end of file
+- [IPv4](/docs/guides/platform/manage-your-usage/ipv4)
+- [Custom Domains](/docs/guides/platform/manage-your-usage/custom-domains)
\ No newline at end of file
diff --git a/apps/docs/content/guides/platform/manage-your-usage/custom-domains.mdx b/apps/docs/content/guides/platform/manage-your-usage/custom-domains.mdx
new file mode 100644
index 00000000000..1b209215315
--- /dev/null
+++ b/apps/docs/content/guides/platform/manage-your-usage/custom-domains.mdx
@@ -0,0 +1,62 @@
+---
+id: 'manage-usage-custom-domains'
+title: 'Manage Custom Domain usage'
+---
+
+## What you are charged for
+You can configure a [custom domain](/docs/guides/platform/custom-domains) for a project by enabling the [Custom Domain add-on](https://supabase.com/dashboard/project/_/settings/addons?panel=customDomain). You are charged for all custom domains configured across your projects.
+
+## How charges are calculated
+Custom domains are charged by the hour, meaning you are charged for the exact number of hours that a custom domain is active. If a custom domain is active for part of an hour, you are still charged for the full hour.
+
+### Example
+Your billing cycle runs from January 1 to January 31. On January 10 at 4:30 PM, you activate a custom domain for your project. At the end of the billing cycle you are billed for 512 hours.
+
+| Time Window                                 | Custom Domain Activated | Hours Billed | Description         |
+|---------------------------------------------|-------------------------|--------------|---------------------|
+| January 1, 00:00 AM - January 10, 4:00 PM   | No                      | 0            |                     |
+| January 10, 04:00 PM - January 10, 4:30 PM  | No                      | 0            |                     |
+| January 10, 04:30 PM - January 10, 5:00 PM  | Yes                     | 1            | full hour is billed |
+| January 10, 05:00 PM - January 31, 23:59 PM | Yes                     | 511          |                     |
+
+
+### Usage on your invoice
+Custom Domain usage is shown as "Custom Domain Hours" on your invoice.
+
+## Pricing
+1 hour is $0.0137 ($10 per month).
+
+## Billing examples
+### One project
+The project has a custom domain activated throughout the entire billing cycle.
+
+| Line Item                     | Hours | Costs   |
+|-------------------------------|-------|---------|
+| Pro Plan                      | -     | $25     |
+| Compute Hours Micro Project 1 | 744   | $10     |
+| Custom Domain Hours           | 744   | $10     |
+| **Subtotal**                  |       | **$45** |
+| Compute Credits               |       | -$10    |
+| **Total**                     |       | **$35** |
+
+### Multiple projects
+All projects have a custom domain activated throughout the entire billing cycle.
+
+| Line Item                     | Hours | Costs   |
+|-------------------------------|-------|---------|
+| Pro Plan                      | -     | $25     |
+|                               |       |         |
+| Compute Hours Micro Project 1 | 744   | $10     |
+| Custom Domain Hours Project 1 | 744   | $10     |
+|                               |       |         |
+| Compute Hours Micro Project 2 | 744   | $10     |
+| Custom Domain Hours Project 2 | 744   | $10     |
+|                               |       |         |
+| **Subtotal**                  |       | **$65** |
+| Compute Credits               |       | -$10    |
+| **Total**                     |       | **$55** |
+
+## Optimize usage
+- Regularly check your projects and remove custom domains that are no longer needed
+- Use free [Vanity subdomains](/docs/guides/platform/custom-domains#vanity-subdomains) where applicable
+