diff --git a/docs/layers/accounts/deploy-accounts.mdx b/docs/layers/accounts/deploy-accounts.mdx
index a7b2f722e..e96b9bb26 100644
--- a/docs/layers/accounts/deploy-accounts.mdx
+++ b/docs/layers/accounts/deploy-accounts.mdx
@@ -106,7 +106,7 @@ This guide walks through deploying AWS accounts using `atmos` workflows. Before
atmos terraform output aws-account/core-artifacts -s core-gbl-root
```
- ### Update the Static Account Map
+ **Update the Static Account Map**
Update the static account map in your organization's defaults file (`stacks/orgs/acme/_defaults.yaml`). This configuration provides account ID lookups for components that need them:
@@ -155,6 +155,15 @@ This guide walks through deploying AWS accounts using `atmos` workflows. Before
:::
As you continue through the setup process, keep an eye out for other placeholder values in your stack configurations and replace them with actual values as needed.
+
+ :::note Stopgap: Deploy the Identity Layer Before Continuing
+ Before proceeding with the remaining account steps, you need to deploy the Identity layer. The Identity layer provisions permission sets with AWS Identity Center that allow you to access each member account, which is required for deploying account settings, CloudTrail, and ECR. We're working on improving this documentation flow and the SuperAdmin profile, but for now, the Identity layer must be deployed at this point.
+ :::
+
+
+ Deploy the Identity layer to provision permission sets for accessing each member account. Return here to finish account settings, CloudTrail, and ECR after the Identity layer is deployed.
+ Deploy Identity Layer
+