Skip to content

docs: clarify custom domain with user/org site#42934

Open
jamietanna wants to merge 1 commit intogithub:mainfrom
jamietanna:patch-2
Open

docs: clarify custom domain with user/org site#42934
jamietanna wants to merge 1 commit intogithub:mainfrom
jamietanna:patch-2

Conversation

@jamietanna
Copy link

As a follow-up to support ticket 4079946 to make it more explicit.

Why:

Closes:

What's being changed (if available, include any code snippets, screenshots, or gifs):

Check off the following:

  • A subject matter expert (SME) has reviewed the technical accuracy of the content in this PR. In most cases, the author can be the SME. Open source contributions may require an SME review from GitHub staff.
  • The changes in this PR meet the docs fundamentals that are required for all content.
  • All CI checks are passing and the changes look good in the review environment.

As a follow-up to support ticket 4079946 to make it more explicit.
Copilot AI review requested due to automatic review settings February 13, 2026 15:48
@welcome
Copy link

welcome bot commented Feb 13, 2026

Thanks for opening this pull request! A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

@github-actions
Copy link
Contributor

How to review these changes 👓

Thank you for your contribution. To review these changes, choose one of the following options:

A Hubber will need to deploy your changes internally to review.

Table of review links

Note: Please update the URL for your staging server or codespace.

The table shows the files in the content directory that were changed in this pull request. This helps you review your changes on a staging server. Changes to the data directory are not included in this table.

Source Review Production What Changed
pages/configuring-a-custom-domain-for-your-github-pages-site/about-custom-domains-and-github-pages.md fpt
ghec
fpt
ghec

Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server

🤖 This comment is automatically generated.

@github-actions github-actions bot added the triage Do not begin working on this issue until triaged by the team label Feb 13, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the GitHub Pages custom domain documentation to more explicitly state when a custom domain configured on a user/organization site applies across project sites, addressing a support-driven clarity gap.

Changes:

  • Clarifies that the “default custom domain applies to all project sites” behavior only applies when the domain is set on a user or organization site.
  • Keeps the existing reference link to the “types of sites” section for additional context.

## Using a custom domain across multiple repositories

If you set a custom domain for a user or organization site, by default, the same custom domain will be used for all project sites owned by the same account. For more information about site types, see [AUTOTITLE](/pages/getting-started-with-github-pages/what-is-github-pages#types-of-github-pages-sites).
If you set a custom domain for a user or organization site, by default, the same custom domain will be used for all project sites owned by the same account. This will only work if the custom domain is set on a user or organization site. For more information about site types, see [AUTOTITLE](/pages/getting-started-with-github-pages/what-is-github-pages#types-of-github-pages-sites).
Copy link

Copilot AI Feb 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The added sentence "This will only work if the custom domain is set on a user or organization site." is redundant with the preceding clause (it restates the same condition) and can read as confusing/tautological. Consider rephrasing to clarify the contrast instead (e.g., that the default only applies when the custom domain is configured on the user/org site, not when it's configured on a project site).

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

triage Do not begin working on this issue until triaged by the team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant