diff --git a/docs/publishing-your-site.md b/docs/publishing-your-site.md index f8318316a..e270d5bba 100644 --- a/docs/publishing-your-site.md +++ b/docs/publishing-your-site.md @@ -205,7 +205,23 @@ Now, when a new commit is pushed to the [default branch] (typically `master` or `main`), the static site is automatically built and deployed. Commit and push the file to your repository to see the workflow in action. -Your documentation should shortly appear at `.gitlab.io/`. +Your documentation is not published under `.gitlab.io/` +by default since **GitLab 17.4** [^1]. However, if you prefer a cleaner URL +structure, such as `.gitlab.io/`, you need to adjust +your configuration. + +To switch from a unique domain to the traditional URL structure, follow +these steps: + +1. Locate Your Repository +2. Go to **Settings › Pages** in the repository menu. +3. In the **Unique domain settings** section, **uncheck** the box labeled +4. **Use unique domain**. +5. Click **Save changes** to apply the update. + +Now you can reach your documentation under `.gitlab.io/`. + +[^1]: [Release notes for Gitlab 17.4](https://about.gitlab.com/releases/2024/09/19/gitlab-17-4-released/) ## Other