← Main Guide Terraform Vault & Secrets API & SDKs Parent/Child

What Are Parent/Child Organizations?

A parent organization is a special StrongDM org that exists solely to administer one or more child organizations. It doesn't have its own infrastructure, resources, or access controls. Think of it as a management console.

Each child organization is a full-featured StrongDM org with its own users, resources, roles, integrations, and audit logs. They are completely isolated from each other.

Think of it like...

A property management company that oversees multiple buildings. The company office (parent org) handles billing and has master keys, but each building (child org) has its own tenants, locks, and day-to-day management. Tenants in Building A can't access Building B.

Architecture

Parent Org
Super admins, billing, org management
Child Org A
Own users, resources, roles, logs
Child Org B
Own users, resources, roles, logs
Child Org C
Own users, resources, roles, logs
2
Levels Only
0
Resources in Parent
1
Unified Bill
Full
Child Isolation

When to Use Parent/Child

Good Fit

Isolated Business Units

Different departments, subsidiaries, or acquired companies need completely separate user directories, roles, and infrastructure. Each unit has its own admins and security policies.

Simplified Billing

Multiple existing StrongDM orgs that need a single invoice. The parent's billing page shows a breakdown of seats used per child organization.

MSP / Multi-Tenant

A managed service provider serving multiple clients, where each client's infrastructure must be completely isolated but managed from a single pane of glass.

Compliance Isolation

Regulatory requirements mandate that certain environments (e.g., PCI, HIPAA) are administered separately with their own audit trail and access controls.

Bad Fit

Tree/Hierarchy Structures

There are only two levels: parent and child. No nesting. No grandchild orgs. No cascading permissions between orgs. If you need a deep hierarchy, this isn't the tool.

The Parent Needs Resources

The parent org cannot host infrastructure, add resources, or manage access controls. It's administration and billing only. If the parent needs to be a functional org, use a regular child org instead.

Shared Integrations

If you depend on a single Slack workspace, SSO app, or ServiceNow instance working across all orgs, you'll hit limitations. Integrations like Slack can only connect to one StrongDM org per workspace.

Shared Users Without Email Aliases

StrongDM requires globally unique email addresses. A user in two child orgs needs two separate email addresses. If your email provider doesn't support aliases (like Gmail's +org1 trick), this gets painful.


How Parent/Child Works

Isolation Model

Child organizations are fully isolated:

FeatureScope
UsersPer child org. A user in Org A has no existence in Org B.
ResourcesPer child org. No resource sharing between orgs.
Roles & AccessPer child org. Roles don't cross boundaries.
Audit LogsPer child org. Each org sees only its own activity.
IntegrationsPer child org. SSO, SCIM, Slack, etc. are configured per org.
PoliciesPer child org. Cedar policies don't propagate.
BillingUnified at parent level. Per-org breakdown visible.

Parent Organization Capabilities

The parent org is intentionally limited. Here's exactly what it can do:

View child orgs See a list of all child organizations, click into read-only settings summaries (auth, logging, security, provisioning) Drop into child orgs Parent admins can switch into any child org and act as a full administrator there. No separate user account needed. Create child orgs Add new child organizations with admin invitations from the parent UI. Manage parent users All parent org users are super admins with access to all child orgs. User management only applies to parent-level users. View billing Unified billing page showing total licenses and per-org utilization. View parent activities Parent-level activities only (creating child orgs, adding parent admins). Not child org activity.
Super Admin Power

Parent admins can drop into any child org as a full admin. They can't directly access resources, but they can make themselves a user, grant themselves permissions, and then access resources. Grant parent-level access with extreme care.

The Email Problem

StrongDM requires globally unique email addresses across all organizations. If the same person needs access to multiple child orgs, they need a separate email address for each. Options:

Each user account in each org consumes a separate license.


Setting Up Parent/Child

You can't set this up yourself -- the initial parent org creation requires StrongDM Support.

  1. Submit a request to StrongDM Support
    Acknowledge that you understand the parent/child model and its limitations. Include the names and email addresses for the users you want as parent org admins (the "super admins"). Ask any remaining questions.
  2. Support creates the parent org
    The StrongDM team creates a new parent organization and migrates your existing org(s) under it as child org(s). Your existing orgs continue to function normally.
  3. Create new child orgs as needed
    From the parent org, go to Organizations > Add child organization. Enter an org name and one or more admin email addresses. Invitations are sent, and once accepted, the child org can be configured like any standard StrongDM org.
  4. Configure each child org
    Each child org is a blank slate. Set up SSO, SCIM, gateways/relays, resources, roles -- the full setup process from the main guide, independently for each child.
After Initial Setup

Once the parent org exists, you can create additional child organizations yourself without contacting Support. Only the initial parent org creation requires their involvement.


Day-to-Day Management

Dropping Into Child Orgs

When logged into the parent org, click your user context menu in the top right. Under Login to organization, select the child org you want to administer. You'll see and manage it as a full admin without needing a separate user account.

Any actions you take in a child org are logged in that child org's Activities section and attributed to your parent admin account.

Billing Overview

The parent org's Billing page shows:

This same unified billing view is also visible from within each child org, so local admins can see the big picture too.

Integration Planning

Integrations are the trickiest part of multi-org deployments. Plan these before creating child orgs:

IntegrationMulti-Org Considerations
SSO (Okta, Entra, etc.)Some IdPs can use one app for multiple orgs (grouping users). Others require separate OIDC/SAML apps per org. Test this before deploying.
SCIM ProvisioningSame as SSO -- may need separate SCIM integrations per child org. User-to-org mapping must be configured in your IdP.
SlackOne StrongDM app per Slack workspace, period. If multiple child orgs share a workspace, only one can integrate with Slack for access workflows.
ServiceNowSame constraint as Slack -- workflow integrations are per-org.
SIEM / Log ExportEach child org has its own audit log stream. Configure SIEM export independently per child.
TerraformEach child org needs its own API key. Use separate Terraform workspaces or state files per child org.
SSO App Strategy

Before standing up multiple child orgs, test your IdP's behavior. For Okta: you may need separate OIDC apps or can use one app with different groups mapped to different orgs. For Entra: separate Enterprise Applications per org is often the safest path. Check compatibility first.


Limitations & Gotchas

The Hard Limits

LimitationDetail
Two levels onlyParent → Child. No grandchild orgs, no nesting, no tree structures.
Parent is not functionalNo resources, no access controls, no infrastructure in the parent org.
Globally unique emailsA single email address can only exist in one org across the entire StrongDM platform.
Separate licenses per userThe same person in two child orgs uses two license seats.
No cross-org resource sharingResources in Org A are invisible to Org B. Period.
No cross-org role inheritanceRoles, policies, and access rules are entirely per-org.
One Slack app per workspaceCan't integrate multiple StrongDM orgs with the same Slack workspace.
Parent admin = super adminAll parent org users have full admin access to every child org.

Frequently Missed Details

Can parent admins see child org audit logs from the parent?

No. The parent org's Activities section only shows parent-level events (creating child orgs, managing parent users). To see a child org's logs, you need to drop into that child org.

Can I move resources between child orgs?

No. Resources exist only in their org. To "move" a resource, you'd need to delete it from one child org and recreate it in another.

Can I create API keys in the parent org?

Yes, but they'd only have access to parent-level operations (not much). For API automation in child orgs, create API keys within each child org.

What happens to child org data if I delete a child org?

Contact StrongDM Support for org deletion. All users, resources, roles, and audit data in that child org would be permanently removed.

Can SCIM provision users across multiple child orgs?

Not from a single SCIM integration. Each child org needs its own SCIM configuration. Your IdP needs to know which users to provision into which org.

Does the parent org consume a license seat?

Parent admin accounts are counted in the parent org's allocation. The billing page shows utilization per org, including the parent.


Decision Checklist

Before requesting parent/child setup, verify all of these:

CheckpointStatus
You need actual isolation (not just RBAC within a single org)Confirm
You understand the parent org has no infrastructure capabilitiesConfirm
Your email provider supports aliases or you have separate emails for multi-org usersConfirm
You've tested your SSO/SCIM provider with multiple org setupsConfirm
You're okay with per-org Slack/ServiceNow integrations (no sharing)Confirm
You've identified who should be parent admins (and you trust them with super admin access)Confirm
You've budgeted for duplicate license seats for multi-org usersConfirm

If you checked all of these, you're ready to contact StrongDM Support.


Note

Content sourced from docs.strongdm.com, March 2026. For the latest on parent/child organization capabilities, contact StrongDM Support.