diff --git a/docs/platform/start/organize/organizations.md b/docs/platform/start/organize/organizations.md
index 73882d31d..e3cfeb0ac 100644
--- a/docs/platform/start/organize/organizations.md
+++ b/docs/platform/start/organize/organizations.md
@@ -18,13 +18,17 @@ Every Mondoo account has at least one organization.
 
 2. Select the **+ ADD ORGANIZATION** box.
 
-3. Enter a name for the organization. The name must be between 4 and 29 characters long and can include letters, numbers, single quotes, hyphens, spaces, and exclamation points.
+    ![add an organization](/img/platform/start/new-org.png)
 
-4. Mondoo picks an organization ID. To customize the ID, select **EDIT** and enter a new ID. The ID must be between 7 and 34 characters and can include lowercase letters, numbers, single quotes, hyphens, spaces, and exclamation points. It must start with a lowercase letter and end with a letter or number.
+3. Mondoo picks an organization ID. To customize the ID, select the pencil icon and enter a new ID. The ID must be between 7 and 34 characters and can include lowercase letters, numbers, single quotes, hyphens, spaces, and exclamation points. It must start with a lowercase letter and end with a letter or number.
 
-5. Check the box to agree to the terms of service and the privacy policy.
+4. Enter a name for the organization. The name must be between 4 and 29 characters long and can include letters, numbers, single quotes, hyphens, spaces, and exclamation points.
 
-6. Select **CREATE ORGANIZATION**
+5. If you want, enter a description for the organization to help your team understand its purpose.
+
+6. Check the box to agree to the terms of service and the privacy policy.
+
+7. Select the **CREATE ORGANIZATION** button.
 
 ## Delete an organization
 
diff --git a/docs/platform/start/organize/spaces.md b/docs/platform/start/organize/spaces.md
index f254e69e3..51f07cade 100644
--- a/docs/platform/start/organize/spaces.md
+++ b/docs/platform/start/organize/spaces.md
@@ -14,6 +14,12 @@ Spaces allow for a great degree of flexibility in managing shared resources. For
 
 Furthermore, users may decide to configure separate spaces for development, staging, and production environments, or specific compliance requirements such as HIPAA or SOC 2.
 
+:::note
+
+Adding and removing spaces requires Owner access to the organization.
+
+:::
+
 ## Manage spaces
 
 You can create new spaces as needed and use them to manage cloud account integrations, policies, and team members separately.
@@ -22,13 +28,19 @@ You can create new spaces as needed and use them to manage cloud account integra
 
 1. [Navigate](/platform/start/navigate) to the organization in which you want to create a space.
 
-2. Select **CREATE NEW SPACE**.
+2. In the left navigation, select **Spaces**.
+
+3. In the top-right corner of the page, select the plus (+) icon.
 
-3. Enter a name for the space. The name must be between 4 and 29 characters long and can include letters, numbers, single quotes, hyphens, spaces, and exclamation points.
+    ![add a space](/img/platform/start/new-space.png)
 
-4. Mondoo picks a space ID. To customize the ID, select **EDIT** and enter a new ID. The ID must be between 7 and 34 characters and can include lowercase letters, numbers, single quotes, hyphens, spaces, and exclamation points. It must start with a lowercase letter and end with a letter or number.
+4. Mondoo picks a space ID. To customize the ID, select the pencil icon and enter a new ID. The ID must be between 7 and 34 characters and can include lowercase letters, numbers, single quotes, hyphens, spaces, and exclamation points. It must start with a lowercase letter and end with a letter or number.
 
-5. Select **CREATE SPACE**.
+5. Enter a name for the space. The name must be between 4 and 29 characters long and can include letters, numbers, single quotes, hyphens, spaces, and exclamation points.
+
+6. If you want, enter a description for the space to help your team understand its purpose.
+
+7. Select the **CREATE SPACE** button.
 
 ### Delete a space
 
@@ -39,8 +51,11 @@ Deleting a space permanently removes it. You can't undo this action.
 :::
 
 1. [Navigate](/platform/start/navigate) to the space you want to delete.
+
 2. Select the **SETTINGS** menu.
+
 3. In the **Danger Zone**, under **Delete Space**, check the box to confirm you want to delete the space and all its related content.
+
 4. Select the **DELETE** button.
 
 ---
diff --git a/static/img/platform/start/new-org.png b/static/img/platform/start/new-org.png
new file mode 100644
index 000000000..a512df8c4
Binary files /dev/null and b/static/img/platform/start/new-org.png differ
diff --git a/static/img/platform/start/new-space.png b/static/img/platform/start/new-space.png
new file mode 100644
index 000000000..7c8f8987f
Binary files /dev/null and b/static/img/platform/start/new-space.png differ