diff --git a/docs/3-using-recce/admin-setup.md b/docs/3-using-recce/admin-setup.md
new file mode 100644
index 00000000..a11d72c5
--- /dev/null
+++ b/docs/3-using-recce/admin-setup.md
@@ -0,0 +1,119 @@
+---
+title: Admin Setup
+---
+
+# Set Up Your Organization
+
+After connecting your Git repo to Recce Cloud, you need to configure your organization so your team can collaborate on PR validation.
+
+**Goal:** Configure your Recce Cloud organization for team collaboration.
+
+When you sign up for Recce Cloud, you get one organization and one project. After connecting to Git, your organization and project names automatically map to your Git provider's names. You can rename them and invite team members.
+
+## Prerequisites
+
+- [x] Recce Cloud account with owner/admin access
+- [x] Git repository connected to Recce Cloud
+- [x] Team members' email addresses
+
+## Steps
+
+### 1. Access organization settings
+
+Navigate to your organization configuration.
+
+1. Log in to [Recce Cloud](https://cloud.reccehq.com)
+2. Click **Settings** → **Organization** in the side panel
+
+**Expected result:** Organization settings page displays your current organization.
+
+{: .shadow}
+
+### 2. Rename your organization (optional)
+
+Update the organization name to match your company or team.
+
+1. In Organization Settings, find the **Organization Name** field
+2. Enter your preferred name
+3. Click **Save**
+
+**Expected result:** Organization name updates across all Recce Cloud pages.
+
+### 3. Set up additional projects (monorepo)
+
+!!! note "For monorepo users"
+ If your repository contains multiple dbt projects, set up additional projects before inviting team members. Skip this step if you have a single dbt project.
+
+1. In Organization Settings, navigate to **Projects**
+2. Click **Add Project**
+3. Enter the project name and select the subdirectory path
+4. Click **Create**
+
+**Expected result:** New project appears in the project list and sidebar.
+
+### 4. Rename your project (optional)
+
+Update the project name if needed.
+
+1. In Organization Settings, navigate to **Projects**
+2. Click on the project you want to rename
+3. Enter the new project name
+4. Click **Save**
+
+**Expected result:** Project name updates in the sidebar and project list.
+
+### 5. Invite team members
+
+Add collaborators to your organization.
+
+1. In Organization Settings, find the **Members** section
+2. Click **Invite Members**
+3. Enter email addresses (use SSO email if members use SSO login)
+4. Select a role for each invitee
+5. Click **Send Invitation**
+6. Tell invitees: when they log in, a modal appears asking them to accept the invitation. See [For Invited Users](#for-invited-users)
+
+| Role | Permissions |
+|------|-------------|
+| **Owner** | The one who created this organization. Full organization management: update info, manage roles, remove members |
+| **Admin** | Same permissions as Owner |
+| **Member** | Upload metadata, launch Recce instances, view organization info |
+
+!!! tip "SSO login requires Team plan or above"
+ SSO login is available on the Team plan and above. See [Pricing](https://www.reccehq.com/pricing) for plan details.
+
+
+**Expected result:** Invitees receive email invitations and see notifications when logged in.
+
+{: .shadow}
+
+## Verify Success
+
+Confirm your setup by checking:
+
+1. Organization name displays correctly in the sidebar
+2. Invited members appear in the Members list (pending or active)
+3. All projects are listed under Settings → Projects
+
+## Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| Invitation not received | Check spam folder; verify email address matches SSO provider |
+| Member sees their own org, not company org | They may have signed up with a different email than the one you invited; ask them to log in with the invited email |
+| Cannot change organization name | Confirm you have Admin role |
+| Project not appearing | Refresh the page; verify the subdirectory path is correct |
+
+## For Invited Users
+
+When you receive an invitation:
+
+1. **Immediate response:** A notification modal appears on login — accept or decline directly
+2. **Later:** Navigate to **Settings** → **Organization** to view pending invitations
+
+{: .shadow}
+
+
diff --git a/docs/6-collaboration/invitation.md b/docs/6-collaboration/invitation.md
deleted file mode 100644
index bf108754..00000000
--- a/docs/6-collaboration/invitation.md
+++ /dev/null
@@ -1,57 +0,0 @@
----
-title: Invitation
----
-
-## Inviting Team Members to Your Recce Organization
-
-To collaborate effectively within Recce Cloud, you can invite team members to join your organization. Follow these steps to send invitations:
-
-### Step 1: Access Organization Settings
-- Log in to your Recce Cloud account
-- Navigate to **Settings** → **Organization** from the side panel
-- Alternatively, you can access directly via: `https://cloud.reccehq.com/settings#organization`
-- In the Organization Settings section, select your desired organization
-
-{: .shadow}
-
-### Step 2: Invite Members
-
-!!! Note
- Please use the SSO email address if your member uses SSO login.
-
-- In the **Members** section, click the **Invite Members** button
-- Enter the email addresses of the individuals you wish to invite
-- Select the appropriate role for each invitee based on the roles below:
-
-#### Organization Roles
-
-| Role | Key Responsibilities | Permissions |
-|------|---------------------|-------------|
-| **ADMIN** | Full organization management | • Update organization info
• Manage member roles
• Remove members
• Transfer storage regions |
-| **MEMBER** | Upload metadata and launch instances | • Upload metadata
• Launch Recce instances
• View organization info and member list
• Leave organization |
-| **VIEWER** | Only instance launch | • Launch Recce instances
• View organization info and member list
• Leave organization |
-
-{: .shadow}
-
-### Step 3: Send Invitation
-- Click the **Send Invitation** button to dispatch the invites
-- Each invitee will receive an email with a link to join your organization
-- Logged-in invitees will also see notifications on their home page or can view pending invitations in **Settings** → **Organization**
-
-## For Invited Users
-
-When you receive an invitation to join a Recce organization, you have several ways to respond:
-
-### Immediate Response
-- Upon login, you'll see a notification modal with the invitations
-- You can immediately accept or decline the invitations directly from the notification without navigating elsewhere
-
-{: .shadow}
-
-### Managing Invitations Later
-- Navigate to **Settings** → **Organization** in your account
-- View all pending invitations in the "Pending Invitations" section
-- Review the organization and role
-- Accept or decline each invitation as needed
-
-{: .shadow}
diff --git a/mkdocs.yml b/mkdocs.yml
index 51446e29..0c17898d 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -67,6 +67,8 @@ nav:
- 3-visualized-change/code-change.md
- 3-visualized-change/column-level-lineage.md
- 3-visualized-change/multi-models.md
+ - Using Recce:
+ - 3-using-recce/admin-setup.md
- Downstream Impacts:
#- 4-downstream-impacts/metadata-first.md
- 4-downstream-impacts/impact-radius.md
@@ -82,7 +84,6 @@ nav:
- 5-data-diffing/query.md
- MCP Server (AI Agents): 5-data-diffing/mcp-server.md
- Collaborate Validation:
- - 6-collaboration/invitation.md
- 6-collaboration/checklist.md
- 6-collaboration/share.md
- CI/CD:
@@ -157,6 +158,7 @@ plugins:
- search
- redirects:
redirect_maps:
+ '6-collaboration/invitation.md': '3-using-recce/admin-setup.md'
'2-getting-started/installation.md': '2-getting-started/oss-setup.md'
'2-getting-started/get-started-jaffle-shop.md': '2-getting-started/jaffle-shop-tutorial.md'
'2-getting-started/oss-vs-cloud.md': '1-whats-recce/cloud-vs-oss.md'