diff --git a/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/docs/asciidoc/packaging-oci-image.adoc b/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/docs/asciidoc/packaging-oci-image.adoc
index 9b12775dbb01..51392c67568a 100644
--- a/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/docs/asciidoc/packaging-oci-image.adoc
+++ b/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/docs/asciidoc/packaging-oci-image.adoc
@@ -374,6 +374,9 @@ The generated image can be published to a Docker registry by enabling a `publish
 If the Docker registry requires authentication, the credentials can be configured using `docker.publishRegistry` properties.
 If the Docker registry does not require authentication, the `docker.publishRegistry` configuration can be omitted.
 
+NOTE: The registry that the image will be published to is determined by the registry part of the image name (`docker.example.com` in these examples).
+If `docker.publishRegistry` credentials are configured and include a `url` property, this value is passed to the registry but is not used to determine the publishing registry location.
+
 [source,groovy,indent=0,subs="verbatim,attributes",role="primary"]
 .Groovy
 ----
diff --git a/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/docs/gradle/packaging/boot-build-image-publish.gradle b/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/docs/gradle/packaging/boot-build-image-publish.gradle
index f3603a4405f9..aaaab48cf4f2 100644
--- a/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/docs/gradle/packaging/boot-build-image-publish.gradle
+++ b/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/docs/gradle/packaging/boot-build-image-publish.gradle
@@ -15,8 +15,6 @@ tasks.named("bootBuildImage") {
 		publishRegistry {
 			username = "user"
 			password = "secret"
-			url = "https://docker.example.com/v1/"
-			email = "user@example.com"
 		}
 	}
 }
diff --git a/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/docs/gradle/packaging/boot-build-image-publish.gradle.kts b/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/docs/gradle/packaging/boot-build-image-publish.gradle.kts
index 6c6d11423019..01bdc5b5204d 100644
--- a/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/docs/gradle/packaging/boot-build-image-publish.gradle.kts
+++ b/spring-boot-project/spring-boot-tools/spring-boot-gradle-plugin/src/docs/gradle/packaging/boot-build-image-publish.gradle.kts
@@ -18,8 +18,6 @@ tasks.named<BootBuildImage>("bootBuildImage") {
 		publishRegistry {
 			username = "user"
 			password = "secret"
-			url = "https://docker.example.com/v1/"
-			email = "user@example.com"
 		}
 	}
 }
diff --git a/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/docs/asciidoc/packaging-oci-image.adoc b/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/docs/asciidoc/packaging-oci-image.adoc
index 16ba0632bcb4..fd2da1264299 100644
--- a/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/docs/asciidoc/packaging-oci-image.adoc
+++ b/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/docs/asciidoc/packaging-oci-image.adoc
@@ -344,6 +344,9 @@ The generated image can be published to a Docker registry by enabling a `publish
 If the Docker registry requires authentication, the credentials can be configured using `docker.publishRegistry` parameters.
 If the Docker registry does not require authentication, the `docker.publishRegistry` configuration can be omitted.
 
+NOTE: The registry that the image will be published to is determined by the registry part of the image name (`docker.example.com` in these examples).
+If `docker.publishRegistry` credentials are configured and include a `url` parameter, this value is passed to the registry but is not used to determine the publishing registry location.
+
 [source,xml,indent=0,subs="verbatim,attributes",tabsize=4]
 ----
 include::../maven/packaging-oci-image/docker-pom.xml[tags=docker]
diff --git a/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/docs/maven/packaging-oci-image/docker-pom.xml b/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/docs/maven/packaging-oci-image/docker-pom.xml
index 377b0c717274..970a19d2e490 100644
--- a/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/docs/maven/packaging-oci-image/docker-pom.xml
+++ b/spring-boot-project/spring-boot-tools/spring-boot-maven-plugin/src/docs/maven/packaging-oci-image/docker-pom.xml
@@ -15,8 +15,6 @@
 						<publishRegistry>
 							<username>user</username>
 							<password>secret</password>
-							<url>https://docker.example.com/v1/</url>
-							<email>user@example.com</email>
 						</publishRegistry>
 					</docker>
 				</configuration>