diff --git a/docs/build_maxtext.md b/docs/build_maxtext.md
index ab1746d699..8ae5541fb3 100644
--- a/docs/build_maxtext.md
+++ b/docs/build_maxtext.md
@@ -128,10 +128,16 @@ build_maxtext_docker_image WORKFLOW=post-training
 
 ## Upload MaxText Docker Image to Artifact Registry
 
-> **Note:** You will need the [**Artifact Registry Writer**](https://docs.cloud.google.com/artifact-registry/docs/access-control#permissions) role to push Docker images to your project's Artifact Registry and to allow the cluster to pull them during workload execution. If you don't have this permission, contact your project administrator to grant you this role through "Google Cloud Console -> IAM -> Grant access".
-
 ```bash
 # Make sure to set `CLOUD_IMAGE_NAME` with your desired image name.
 export CLOUD_IMAGE_NAME=<Docker Image Name>
 upload_maxtext_docker_image CLOUD_IMAGE_NAME=${CLOUD_IMAGE_NAME?}
 ```
+
+> **Note:** You will need the [**Artifact Registry Writer**](https://docs.cloud.google.com/artifact-registry/docs/access-control#permissions) role to push Docker images to your project's Artifact Registry and to allow the cluster to pull them during workload execution. If you don't have this permission, contact your project administrator to grant you this role through "Google Cloud Console -> IAM -> Grant access".
+
+> **Note:** If you see the following error, try adding the listed file path to `.dockerignore`:
+> ```
+> ERROR: Found symbolic links with absolute paths in the build context:
+> ./<add_this_value_to_dockerignore>
+> ```