diff --git a/spring-shell-docs/modules/ROOT/nav.adoc b/spring-shell-docs/modules/ROOT/nav.adoc
index 5812b07a..b5bf5601 100644
--- a/spring-shell-docs/modules/ROOT/nav.adoc
+++ b/spring-shell-docs/modules/ROOT/nav.adoc
@@ -65,12 +65,12 @@
 *** xref:tui/events/eventloop.adoc[]
 *** xref:tui/events/key.adoc[]
 *** xref:tui/events/mouse.adoc[]
-* xref:using-shell-customization.adoc[]
-** xref:using-shell-customization-styling.adoc[]
-** xref:using-shell-customization-logging.adoc[]
-** xref:using-shell-customization-commandnotfound.adoc[]
-** xref:using-shell-customization-singlecommand.adoc[]
-** xref:using-shell-customization-contextclose.adoc[]
+* xref:customization/index.adoc[]
+** xref:customization/styling.adoc[]
+** xref:customization/logging.adoc[]
+** xref:customization/commandnotfound.adoc[]
+** xref:customization/singlecommand.adoc[]
+** xref:customization/contextclose.adoc[]
 * xref:using-shell-execution.adoc[]
 * xref:using-shell-testing.adoc[]
 ** xref:using-shell-testing-basics.adoc[]
diff --git a/spring-shell-docs/modules/ROOT/pages/using-shell-customization-commandnotfound.adoc b/spring-shell-docs/modules/ROOT/pages/customization/commandnotfound.adoc
similarity index 100%
rename from spring-shell-docs/modules/ROOT/pages/using-shell-customization-commandnotfound.adoc
rename to spring-shell-docs/modules/ROOT/pages/customization/commandnotfound.adoc
diff --git a/spring-shell-docs/modules/ROOT/pages/using-shell-customization-contextclose.adoc b/spring-shell-docs/modules/ROOT/pages/customization/contextclose.adoc
similarity index 100%
rename from spring-shell-docs/modules/ROOT/pages/using-shell-customization-contextclose.adoc
rename to spring-shell-docs/modules/ROOT/pages/customization/contextclose.adoc
diff --git a/spring-shell-docs/modules/ROOT/pages/using-shell-customization.adoc b/spring-shell-docs/modules/ROOT/pages/customization/index.adoc
similarity index 100%
rename from spring-shell-docs/modules/ROOT/pages/using-shell-customization.adoc
rename to spring-shell-docs/modules/ROOT/pages/customization/index.adoc
diff --git a/spring-shell-docs/modules/ROOT/pages/using-shell-customization-logging.adoc b/spring-shell-docs/modules/ROOT/pages/customization/logging.adoc
similarity index 100%
rename from spring-shell-docs/modules/ROOT/pages/using-shell-customization-logging.adoc
rename to spring-shell-docs/modules/ROOT/pages/customization/logging.adoc
diff --git a/spring-shell-docs/modules/ROOT/pages/using-shell-customization-singlecommand.adoc b/spring-shell-docs/modules/ROOT/pages/customization/singlecommand.adoc
similarity index 100%
rename from spring-shell-docs/modules/ROOT/pages/using-shell-customization-singlecommand.adoc
rename to spring-shell-docs/modules/ROOT/pages/customization/singlecommand.adoc
diff --git a/spring-shell-docs/modules/ROOT/pages/using-shell-customization-styling.adoc b/spring-shell-docs/modules/ROOT/pages/customization/styling.adoc
similarity index 100%
rename from spring-shell-docs/modules/ROOT/pages/using-shell-customization-styling.adoc
rename to spring-shell-docs/modules/ROOT/pages/customization/styling.adoc
diff --git a/spring-shell-docs/modules/ROOT/pages/getting-started.adoc b/spring-shell-docs/modules/ROOT/pages/getting-started.adoc
index bc44c949..f4b7bc01 100644
--- a/spring-shell-docs/modules/ROOT/pages/getting-started.adoc
+++ b/spring-shell-docs/modules/ROOT/pages/getting-started.adoc
@@ -87,7 +87,7 @@ Or in non-interactive mode:
 include::example$getting-started-run-noninteractive.out[]
 ----
 
-TIP: Check out xref:using-shell-customization-logging.adoc[Logging] making logging to work
+TIP: Check out xref:/customization/logging.adoc[Logging] making logging to work
 better with shell apps.
 
 [[using-spring-shell-your-first-command]]