Skip to content

Document child org Organization Group defaults - #41661

Open
tomnof wants to merge 2 commits into
masterfrom
dd/tomnof/org-group-child-defaults-20261111
Open

tomnof wants to merge 2 commits into
masterfrom
dd/tomnof/org-group-child-defaults-20261111

Conversation

@tomnof

@tomnof tomnof commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

What does this PR do? What is the motivation?

Documents that newly created child organizations automatically join the hierarchy root's Organization Group and immediately receive its policies and shared roles. Clarifies that this default applies to creation through the UI, the API (POST /api/v1/org), and Terraform, and that child organizations can also be created directly from an Organization Group in the UI.

Merge readiness

  • Ready for merge

AI assistance

Used Bits Code to draft the documentation update and check repository conventions.

For Datadog employees:

  • ⚠️ Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). If you've already created your PR with an incorrect branch name, please rename your branch and open a fresh PR.
  • 🤖 New: Comment with /review to run an automated check that catches common issues before a Documentation team member reviews your PR.

Additional notes

Validation: Repository pre-commit content checks passed. Vale could not run because it is not installed in the sandbox. A local site build was not run for this Markdown-only change.


PR by Bits - View session in Datadog • Open in Slack

Comment @DataDog to request changes

Co-authored-by: tomnof <23119680+tomnof@users.noreply.github.com>
@datadog-prod-us1-4

datadog-prod-us1-4 Bot commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

View session in Datadog

Bits Code status: ✅ Done

CI Auto-fix: Disabled | Enable

Comment @DataDog to request changes

@tomnof
tomnof requested review from a team as code owners November 11, 2026 21:47
Co-authored-by: tomnof <23119680+tomnof@users.noreply.github.com>

@maycmlee maycmlee left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Left a suggestion and question


### Default group for child organizations

When you create a child organization, Datadog automatically adds it to the Organization Group of the root organization in its hierarchy. In a multi-level hierarchy, this is the root organization's group, not the immediate parent's group. The child organization immediately receives the group's policies and shared roles.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
When you create a child organization, Datadog automatically adds it to the Organization Group of the root organization in its hierarchy. In a multi-level hierarchy, this is the root organization's group, not the immediate parent's group. The child organization immediately receives the group's policies and shared roles.
When you create a child organization, Datadog automatically adds it to the Organization Group of the root organization in its hierarchy. In a multi-level hierarchy, this is the root organization's group, not the immediate parent's group. The child organization immediately receives the root organization group's policies and shared roles.

Is this correct?

@github-actions

Copy link
Copy Markdown
Contributor

Preview links (active after the build_preview check completes)

Modified Files

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants