Skip to content

Commit 307fceb

Browse files
authored
Updated publish comment on gitlab (#7853)
* docs(publish gitlab pages): Update publish comment on gitlab * docs(publish gitlab): Add guide how to disable unique domains * docs(publish gitlab pages): Solve some styling issues
1 parent 8e4bcb1 commit 307fceb

File tree

1 file changed

+17
-1
lines changed

1 file changed

+17
-1
lines changed

docs/publishing-your-site.md

+17-1
Original file line numberDiff line numberDiff line change
@@ -205,7 +205,23 @@ Now, when a new commit is pushed to the [default branch] (typically `master` or
205205
`main`), the static site is automatically built and deployed. Commit and push
206206
the file to your repository to see the workflow in action.
207207

208-
Your documentation should shortly appear at `<username>.gitlab.io/<repository>`.
208+
Your documentation is not published under `<username>.gitlab.io/<repository>`
209+
by default since **GitLab 17.4** [^1]. However, if you prefer a cleaner URL
210+
structure, such as `<username>.gitlab.io/<repository>`, you need to adjust
211+
your configuration.
212+
213+
To switch from a unique domain to the traditional URL structure, follow
214+
these steps:
215+
216+
1. Locate Your Repository
217+
2. Go to **Settings › Pages** in the repository menu.
218+
3. In the **Unique domain settings** section, **uncheck** the box labeled
219+
4. **Use unique domain**.
220+
5. Click **Save changes** to apply the update.
221+
222+
Now you can reach your documentation under `<username>.gitlab.io/<repository>`.
223+
224+
[^1]: [Release notes for Gitlab 17.4](https://about.gitlab.com/releases/2024/09/19/gitlab-17-4-released/)
209225

210226
## Other
211227

0 commit comments

Comments
 (0)