Organizations — When to Create One & How They Work
Overview
An Organization in Vantage is a top-level entity that groups multiple companies together. It enables cross-company dashboard sharing, centralized user management, and unified billing oversight. Not every account needs an organization — it's designed for businesses that manage multiple teams, departments, or clients.
What Is an Organization?
An Organization sits above Companies in the hierarchy:
Key Benefits
- Cross-company dashboard sharing — Dashboards can be shared across companies within the same organization.
- Centralized user management — Admins can manage users across all companies.
- Organization-wide AI context — AI context snippets marked as "org-level" apply to all users in all companies.
- Organization-wide usage logs — Track token usage across all companies.
- Global settings — Set organization-wide policies (e.g., integration restrictions, sharing policies).
When to Create an Organization
✅ You SHOULD create an organization when:
- You have multiple departments or teams that each need their own isolated company workspace, but also need to share dashboards or data across departments.
- You're an agency or MSP managing multiple client companies and need a unified admin view.
- You want centralized control over AI settings, integration policies, and usage tracking across multiple companies.
- You need cross-company reporting — e.g., the CEO wants to see dashboards from both the Marketing and Sales companies.
❌ You DON'T need an organization when:
- You only have one team — A single company is sufficient.
- All users should see the same data — Keep everyone in one company.
- You don't need cross-company sharing — Companies work fine independently.
How to Create an Organization
- Navigate to Settings from the sidebar.
- In the left navigation panel, under the Organization section, click "Organization".
- If you don't already belong to an organization, you'll see the "Create Organization" form.
- If you do belong to one, you'll see the Organization Settings page instead.
- Enter your Organization Name (e.g., "Acme Corp").
- Click "Create Organization".
- You'll see a success message: 'Organization "Acme Corp" created!'
- Sign out and sign back in for the changes to take effect.
Important: After creating an organization, you must sign out and sign back in. This is required because the organization ID is stored in your session, and it needs to be refreshed.
Organization Settings
Once your organization is created and you've signed back in, the Organization tab in Settings changes to show Organization Settings (the OrgGlobalSettings component). Here you can manage:
- Cross-company sharing policies — Control whether dashboards can be shared between companies in the organization.
- Organization-wide AI context — Set AI context snippets that apply to all users across all companies.
- Integration restrictions — Manage domain restrictions and integration policies at the organization level.
Organization-Level Navigation
When you belong to an organization, additional settings tabs become available:
| Tab | Description |
|---|---|
| Organization | Manage organization-wide sharing policies and settings. |
| Usage Logs | View token usage logs across all companies in the organization. |
| Users | Manage users across all companies. |
| Companies | View all companies in the organization. |
How Organizations Affect Dashboards
With an organization, dashboards are categorized into three groups:
| Group | Description |
|---|---|
| Mine | Dashboards you personally created. |
| Company | Dashboards shared within your company. Visible to all users in your company. |
| Organization | Dashboards shared at the organization level. Visible to users across all companies in the organization (when cross-company sharing is enabled). |
Troubleshooting
| Issue | Solution |
|---|---|
| Can't see Organization tab | If you already belong to an organization, it shows "Organization Settings" instead of "Create Organization". |
| Changes not visible after creation | You must sign out and sign back in after creating an organization. |
| Can't manage organization settings | You need the manage_organization permission in your role. |
| Users in other companies can't see shared dashboards | Verify cross-company sharing is enabled in Organization Settings. |