Organization hierarchy
At the top of the Google Cloud resource hierarchy sits the organization node. This is the root for all your resources and the most common place to apply organization-wide policies, IAM bindings, and identity management. Beneath the organization node you can create folders to logically group related projects. For example:- Marketing
- Data Engineering
- Finance
The organization node is the most powerful scope. Apply permissions there only when you want the role to affect every folder, project, and resource in the organization.
How IAM inheritance works
- Organization-level bindings apply to all folders, projects, and resources under that organization node.
- Folder-level bindings apply to projects and resources contained in that folder.
- Project-level bindings apply only to resources inside that project.
| Scope | Applies to | Typical use |
|---|---|---|
| Organization | All folders, projects, and resources | Global policies, org-wide auditors, central admins |
| Folder | Projects and resources in the folder | Departmental teams, shared infrastructure groups |
| Project | Resources in the project only | Application owners, CI/CD pipelines, project-specific roles |
Org-level roles: Viewer, Editor, Owner
There are three primitive predefined roles in Google Cloud that are commonly used at the organization level. They grant increasing levels of access:-
Viewer
- Read-only access to view resources and configuration.
- Useful for monitoring logs, reviewing configurations, or auditing usage.
- Cannot make changes or modify configuration.
-
Editor
- Can create, modify, and delete resources (Compute Engine, BigQuery, Cloud Storage, Cloud Functions, etc.).
- Cannot manage IAM policies (cannot grant or revoke roles).
-
Owner
- Full administrative control, including the ability to manage IAM.
- Can grant/revoke roles, invite/remove principals, and delete projects and resources.
| Role | Typical permissions | When to use |
|---|---|---|
| Viewer | Read-only across the scope | Reporters, auditors, non-admin stakeholders |
| Editor | Modify/create/delete resources (no IAM) | Developers, operators who manage resources but not IAM |
| Owner | All Editor permissions + IAM management | Trusted administrators who manage org policies and access |

Practical guidance
- Follow least privilege: grant the most restrictive role that still allows the user to perform their tasks.
- Prefer assigning roles at the project or folder level rather than the organization level to reduce blast radius.
- Limit organization-level Owner assignments to a very small group of trusted administrators.
- Use predefined and custom roles appropriately — predefined primitive roles are broad; consider fine-grained predefined or custom roles for production use.
Be careful granting Owner at the organization level — that role can change IAM policies across the entire organization, including deleting projects and revoking other admins.