From 63adb5f2308d6b23550b191edff4e2b145deba8e Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Mon, 5 Jan 2026 17:10:49 +0000 Subject: [PATCH 1/2] Document custom domain setup in dashboard Co-Authored-By: Fern Support --- .../docs/pages/changelog/2026-01-05.mdx | 5 ++ .../setting-up-your-domain.mdx | 48 +++++++++++++++++-- 2 files changed, 48 insertions(+), 5 deletions(-) create mode 100644 fern/products/docs/pages/changelog/2026-01-05.mdx diff --git a/fern/products/docs/pages/changelog/2026-01-05.mdx b/fern/products/docs/pages/changelog/2026-01-05.mdx new file mode 100644 index 000000000..77fd481d9 --- /dev/null +++ b/fern/products/docs/pages/changelog/2026-01-05.mdx @@ -0,0 +1,5 @@ +## Set up custom domains in the dashboard + +You can now configure custom domains for your documentation site directly in the [Fern Dashboard](https://dashboard.buildwithfern.com/). The dashboard displays the DNS records you need to add to your domain registrar, eliminating the need to contact Fern support. + +[Learn more](/learn/docs/preview-publish/setting-up-your-domain) about setting up your custom domain. diff --git a/fern/products/docs/pages/getting-started/setting-up-your-domain.mdx b/fern/products/docs/pages/getting-started/setting-up-your-domain.mdx index 1bf279fa0..f6a4e0e53 100644 --- a/fern/products/docs/pages/getting-started/setting-up-your-domain.mdx +++ b/fern/products/docs/pages/getting-started/setting-up-your-domain.mdx @@ -8,9 +8,47 @@ Bring Fern Docs to your custom domain. You can use: - A subpath on your custom domain, such as `mydomain.com/docs` - A root domain, such as `mydomain.com` - - Once you've set up your domain, use the [Fern Dashboard](https://dashboard.buildwithfern.com/) to manage site settings. - +You can set up your custom domain directly in the [Fern Dashboard](https://dashboard.buildwithfern.com/), or configure it manually using DNS records. + +## Set up via the dashboard + +The Fern Dashboard provides a self-service way to configure your custom domain. + + + +### Update the domain in `docs.yml` + +Add your `custom-domain` to your `docs.yml` configuration and merge your changes into `main`. + +```yaml docs.yml +instances: + - url: example.docs.buildwithfern.com + custom-domain: docs.mydomain.com +``` + +### Open the dashboard + +Navigate to the [Fern Dashboard](https://dashboard.buildwithfern.com/) and select your documentation site. + +### Add your custom domain + +In the site settings, enter your custom domain. The dashboard displays the DNS records you need to configure. + +### Configure DNS records + +Log in to your domain registrar's dashboard and add the DNS records shown in the Fern Dashboard. The specific records depend on your domain type (subdomain, subpath, or root domain). + +### Verify the setup + +Once you've added the DNS records, return to the Fern Dashboard to verify your domain. SSL is automatically provisioned for your domain, but it may take a few minutes to propagate globally. + +Check that you can access your new docs site from a mobile device or incognito browser. + + + +## Set up manually + +If you prefer to configure your domain manually, expand the section below that matches your domain type. @@ -189,5 +227,5 @@ instances: This works with any of the above domain types (subdomain, subpath, or root domain). -After configuring multiple domains in your `docs.yml`, contact Fern via your dedicated Slack channel or [email](mailto:support@buildwithfern.com) to complete the setup. You'll receive DNS configuration details for each domain. - \ No newline at end of file +After configuring multiple domains in your `docs.yml`, use the [Fern Dashboard](https://dashboard.buildwithfern.com/) to add each domain and retrieve the DNS records. Alternatively, contact Fern via your dedicated Slack channel or [email](mailto:support@buildwithfern.com) to complete the setup. + \ No newline at end of file From 7129dca09c4673f3cff07a2761b8290ceeff8279 Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Wed, 7 Jan 2026 14:23:02 -0500 Subject: [PATCH 2/2] move info to dashboard product --- fern/products/dashboard/dashboard.yml | 2 + .../dashboard/pages/changelog/2026-01-07.mdx | 5 + fern/products/dashboard/pages/domains.mdx | 64 ++++++++++ fern/products/dashboard/pages/overview.mdx | 9 +- .../docs/pages/changelog/2026-01-05.mdx | 6 - .../setting-up-your-domain.mdx | 111 +++++++----------- 6 files changed, 120 insertions(+), 77 deletions(-) create mode 100644 fern/products/dashboard/pages/changelog/2026-01-07.mdx create mode 100644 fern/products/dashboard/pages/domains.mdx diff --git a/fern/products/dashboard/dashboard.yml b/fern/products/dashboard/dashboard.yml index f395ce16f..7b54272d4 100644 --- a/fern/products/dashboard/dashboard.yml +++ b/fern/products/dashboard/dashboard.yml @@ -11,4 +11,6 @@ navigation: - page: Set up SSO path: ./pages/sso.mdx slug: sso + - page: Custom domains + path: ./pages/domains.mdx - changelog: ./pages/changelog diff --git a/fern/products/dashboard/pages/changelog/2026-01-07.mdx b/fern/products/dashboard/pages/changelog/2026-01-07.mdx new file mode 100644 index 000000000..abee51f47 --- /dev/null +++ b/fern/products/dashboard/pages/changelog/2026-01-07.mdx @@ -0,0 +1,5 @@ +## Set up custom domains in the dashboard + +You can now configure custom domains for your documentation site directly in the [Fern Dashboard](https://dashboard.buildwithfern.com/). The dashboard automatically displays the DNS records you need to add to your domain registrar based on your domain type. + +[Learn more](/learn/dashboard/configuration/custom-domains) about setting up your custom domain. \ No newline at end of file diff --git a/fern/products/dashboard/pages/domains.mdx b/fern/products/dashboard/pages/domains.mdx new file mode 100644 index 000000000..8ba292a17 --- /dev/null +++ b/fern/products/dashboard/pages/domains.mdx @@ -0,0 +1,64 @@ +--- +title: Set up a custom domain +description: Use the Fern Dashboard to configure your custom domain with DNS records for subdomain, subpath, or root domain hosting. +--- + +You can use the [Fern Dashboard](https://dashboard.buildwithfern.com/) to configure any of the following custom domain types: +- **Subdomain**: `docs.mydomain.com` +- **Subpath**: `mydomain.com/docs` +- **Root domain**: `mydomain.com` + +The Dashboard automatically provides the correct DNS records based on your domain type. + + + Alternatively, you can [set up your custom domain by manually configuring DNS records](/learn/docs/preview-publish/setting-up-your-domain). + + +## Setup + + + + +Navigate to the [Fern Dashboard](https://dashboard.buildwithfern.com/) and select your documentation site. + + + + +In the **Domains** section of the **Overview** tab, select **Add Custom Domain** and enter your domain. The dashboard displays the DNS records you need to configure. + +For multiple custom domains (e.g., partner or white-label deployments), repeat this step to add each domain. + + + + +Add your `custom-domain` to your `docs.yml` configuration: + +```yaml docs.yml +instances: + - url: example.docs.buildwithfern.com + custom-domain: docs.mydomain.com +``` + +For multiple custom domains, configure an array: + +```yaml docs.yml +instances: + - url: example.docs.buildwithfern.com + custom-domain: + - www.mydomain.com + - partner.otherdomain.com +``` + + + + +Log in to your domain registrar and add the DNS records shown in the Fern Dashboard. The specific records depend on your domain type (subdomain, subpath, or root domain). + + + + +Once you've added the DNS records, return to the Fern Dashboard to verify your domain. SSL is automatically provisioned for your domain, but it may take a few minutes to propagate globally. + +Check that you can access your new docs site from a mobile device or incognito browser. + + diff --git a/fern/products/dashboard/pages/overview.mdx b/fern/products/dashboard/pages/overview.mdx index 932ac8b96..324e538fa 100644 --- a/fern/products/dashboard/pages/overview.mdx +++ b/fern/products/dashboard/pages/overview.mdx @@ -9,7 +9,14 @@ The Fern Dashboard provides a central place to manage your projects, team member Visit your team's [Dashboard](https://dashboard.buildwithfern.com/) and complete initial setup steps: - + + + Configure your custom domain with automatic DNS record provisioning. + ` component now supports a `collapsed` prop to control th This is useful for embedding multiple endpoints on a page or reducing visual clutter while maintaining interactive API testing. Learn more about the [Runnable Endpoint](/learn/docs/writing-content/components/runnable-endpoint) component. - -## Set up custom domains in the dashboard - -You can now configure custom domains for your documentation site directly in the [Fern Dashboard](https://dashboard.buildwithfern.com/). The dashboard displays the DNS records you need to add to your domain registrar, eliminating the need to contact Fern support. - -[Learn more](/learn/docs/preview-publish/setting-up-your-domain) about setting up your custom domain. diff --git a/fern/products/docs/pages/getting-started/setting-up-your-domain.mdx b/fern/products/docs/pages/getting-started/setting-up-your-domain.mdx index f6a4e0e53..7313a11c4 100644 --- a/fern/products/docs/pages/getting-started/setting-up-your-domain.mdx +++ b/fern/products/docs/pages/getting-started/setting-up-your-domain.mdx @@ -3,61 +3,24 @@ title: Bring your custom domain description: Learn how to set up your Fern-generated documentation site to use a custom subdomain or subpath. --- -Bring Fern Docs to your custom domain. You can use: -- A subdomain on your custom domain, such as `docs.mydomain.com` -- A subpath on your custom domain, such as `mydomain.com/docs` -- A root domain, such as `mydomain.com` +You can configure any of the following custom domain types: +- **Subdomain**: `docs.mydomain.com` +- **Subpath**: `mydomain.com/docs` +- **Root domain**: `mydomain.com` -You can set up your custom domain directly in the [Fern Dashboard](https://dashboard.buildwithfern.com/), or configure it manually using DNS records. +Fern recommends [using the Fern Dashboard to set up custom domains](/learn/dashboard/configuration/custom-domains). The Dashboard automatically provides the correct DNS records based on your domain type. If you prefer to configure your domain manually, follow the instructions on this page. -## Set up via the dashboard +## Manual setup -The Fern Dashboard provides a self-service way to configure your custom domain. - - - -### Update the domain in `docs.yml` - -Add your `custom-domain` to your `docs.yml` configuration and merge your changes into `main`. - -```yaml docs.yml -instances: - - url: example.docs.buildwithfern.com - custom-domain: docs.mydomain.com -``` - -### Open the dashboard - -Navigate to the [Fern Dashboard](https://dashboard.buildwithfern.com/) and select your documentation site. - -### Add your custom domain - -In the site settings, enter your custom domain. The dashboard displays the DNS records you need to configure. - -### Configure DNS records - -Log in to your domain registrar's dashboard and add the DNS records shown in the Fern Dashboard. The specific records depend on your domain type (subdomain, subpath, or root domain). - -### Verify the setup - -Once you've added the DNS records, return to the Fern Dashboard to verify your domain. SSL is automatically provisioned for your domain, but it may take a few minutes to propagate globally. - -Check that you can access your new docs site from a mobile device or incognito browser. - - - -## Set up manually - -If you prefer to configure your domain manually, expand the section below that matches your domain type. +Expand the section below that matches your domain type: - + To host your documentation on a subdomain like `docs.mydomain.com`, you need to create a CNAME record in your DNS settings. - -### Update the domain in `docs.yml` + Add your `custom-domain` and merge your changes into `main`. [Here's an example](https://github.com/octoml/fern-config/blob/389b67679953856ba0716537981a6d749635556f/fern/docs.yml#L1-L3 ). @@ -66,14 +29,16 @@ instances: - url: example.docs.buildwithfern.com custom-domain: docs.mydomain.com ``` + -### Contact Fern + Contact Fern via your dedicated Slack channel or [email](mailto:support@buildwithfern.com) to receive: - A unique CNAME value for your site - A TXT record to verify your domain + -### Create DNS records + Log in to your domain registrar's dashboard and navigate to the DNS settings for your domain. Add the following records: @@ -96,34 +61,36 @@ Replace `docs` with any subdomain you want to use. If you are using Cloudflare, you should ensure the record isn't proxied. + -### Verify the setup + Once Fern has completed your setup, you'll be able to access your documentation at `docs.mydomain.com`. SSL will be automatically provisioned for your domain, but it may take a few minutes to propagate globally. Check that you can access your new docs site from a mobile device or incognito browser. + - + To host your documentation on a subpath like `mydomain.com/docs`, you need to edit your `docs.yml` configuration and then get provider-specific instructions for setting up the subpath. Common providers include Cloudflare, AWS Route53 and Cloudfront, Netlify, and Vercel. - -### Configure the `url` in `docs.yml` + Append that subpath to the end of the `url`. This example use `docs` for the subpath, but you can use any word you like, such as `reference` or `developer`. ```yaml -instances: +instances: - url: example.docs.buildwithfern.com/docs ``` + -### Configure the `custom-domain` + Below the `url`, add a `custom-domain` key: @@ -136,26 +103,28 @@ instances: [Here's an example.](https://github.com/fern-api/fern/blob/7d8631c6119787a8aaccb4ba49837e73c985db28/fern/docs.yml#L1-L3) + -### Contact Fern + -Contact Fern via your dedicated Slack channel or [email](mailto:support@buildwithfern.com) to set up your custom subpath. +Contact Fern via your dedicated Slack channel or [email](mailto:support@buildwithfern.com) to set up your custom subpath. + -### Verify the setup + Once Fern has completed your setup, you'll be able to access your documentation at `mydomain.com/docs`. It may take a few minutes for DNS changes to propagate globally. Check that you can access your new docs site from a mobile device or incognito browser. + - + To host your documentation on a root domain like `mydomain.com`, you need to edit your `docs.yml` configuration and then get provider-specific instructions for setting up the domain. Common providers include Cloudflare, AWS Route53 and Cloudfront, Netlify, and Vercel. - -### Configure the `url` in `docs.yml` + ```yaml @@ -166,14 +135,16 @@ instances: [Here's an example.](https://github.com/dannysheridan/katiedanny/blob/2fcf5769e2994af29e31d00904e04788b188a18b/fern/docs.yml#L3-L5) + -### Contact Fern + Contact Fern via your dedicated Slack channel or [email](mailto:support@buildwithfern.com) to receive: - A unique CNAME value for your site - A TXT record to verify your domain + -### Configure your DNS settings + You'll need the following DNS records configured for your root domain. @@ -201,20 +172,22 @@ TXT @ [TXT record value provided by Fern] This redirects `mydomain.com` to `www.mydomain.com`. After you add these records, Fern will provision a SSL certificate. + -### Verify the setup + Once Fern has completed your setup, you'll be able to access your documentation at `mydomain.com`. SSL will be automatically provisioned for your domain, but it may take a few minutes to propagate globally. Check that you can access your new docs site from a mobile device or incognito browser. + - + -## Multiple custom domains +### Multiple custom domains -To serve your documentation from multiple custom domains (e.g., for partner or white-label deployments), configure an array of domains: +To serve your documentation from multiple custom domains (e.g., for partner or white-label deployments), follow the above steps for each domain (subdomain, subpath, or root domain), then configure an array in your `docs.yml`: ```yaml docs.yml instances: @@ -224,8 +197,6 @@ instances: - partner.otherdomain.com ``` -This works with any of the above domain types (subdomain, subpath, or root domain). - -After configuring multiple domains in your `docs.yml`, use the [Fern Dashboard](https://dashboard.buildwithfern.com/) to add each domain and retrieve the DNS records. Alternatively, contact Fern via your dedicated Slack channel or [email](mailto:support@buildwithfern.com) to complete the setup. - \ No newline at end of file +After configuring multiple domains in your `docs.yml`, contact Fern via your dedicated Slack channel or [email](mailto:support@buildwithfern.com) to complete the setup. You'll receive DNS configuration details for each domain. +