{"section":"tutorials","requestedLocale":"en","requestedSlug":"adding-or-editing-organizational-units","locale":"en","slug":"adding-or-editing-organizational-units","path":"docs/en/tutorials/b2b/organization-account/adding-or-editing-organizational-units.md","branch":"main","content":"> ⚠️ This feature is only available to stores using [B2B Buyer Portal](https://help.vtex.com/en/docs/tutorials/b2b-buyer-portal), which is currently available for selected accounts.\n\n**Organizational units** (OU) allow companies to manage their internal structures in a hierarchical manner, with their own budgets, internal approval flows, purchasing autonomy, and other subdivision levels. This way a single B2B company can operate with multiple internal structures, maintaining contractual consistency and operational control.\n\nIn this article, you'll learn how to manage organizational units through the following sections:\n\n- [Adding an organizational unit](#adding-an-organizational-unit)\n- [Renaming an organizational unit](#renaming-an-organizational-unit)\n- [Adding a user to an organizational unit](#adding-a-user-to-an-organizational-unit)\n- [Adding a child (sub) organizational unit](#adding-a-child-sub-organizational-unit)\n- [Removing an organizational unit](#removing-an-organizational-unit)\n\n> ⚠️ To configure organizational units, the user's [Storefront Role](https://developers.vtex.com/docs/guides/storefront-roles) must be `Organizational Unit Admin`, `Super Buyer Admin`, or have the `ManageOrganizationHierarchy` resource.\n\n## Adding an organizational unit\n\n1. On the organization account homepage, in the **Organization** section, click `Organizational units`.\n\n \n\n2. On the **Organizational units** screen, click the `+` icon.\n\n3. Make sure the **Parent** field contains the organizational unit that the new unit should go under, that is, the unit it will be a child of. This field can't be edited.\n\n4. Enter the name of the new organizational unit. You can [rename it](#renaming-an-organizational-unit) later.\n\n5. Click `Add`.\n\nAfter creating an organizational unit, it will be listed on the **Organizational units** screen. You can access the organization account page for the unit by clicking its row.\n\n## Renaming an organizational unit\n\n1. On the **Organizational units** page, in the row of the organizational unit you want to rename, click the menu icon > `Rename`.\n2. Make the desired changes.\n3. Click `Save`.\n\n## Adding a user to an organizational unit\n\n1. On the **Organizational units** page, in the row of the organizational unit you want to add a user to, click the menu icon > `Add user`.\n2. Complete the new user information:\n - Name\n - Email\n - Phone number (optional)\n - Username\n3. Select the roles you want to assign to the user.\n\n > ℹ️ For more information about roles in [B2B Buyer Portal](https://help.vtex.com/en/docs/tutorials/b2b-buyer-portal), see the article [Storefront Roles](https://developers.vtex.com/docs/guides/storefront-roles).\n\n4. Click `Add`.\n\n## Adding a child (sub) organizational unit\n\n1. On the **Organizational units** page, in the row of the desired organizational unit, click the menu icon > `Add organizational unit`.\n2. Make sure the **Parent** field contains the correct organizational unit the new unit should go under, that is, the one it should be a child of. This field can't be edited.\n3. Enter the name of the child organizational unit.\n4. Click `Add`.\n\n## Removing an organizational unit\n\n> ❗ To remove an organizational unit that has child units, you must first remove each child unit individually, starting with the lowest level.\n\n1. On the **Organizational units** page, in the row of the organizational unit you want to remove, click the menu icon > `Delete`.\n2. Enter the name of the organizational unit. This field is case sensitive.\n3. Click `Delete`.\n\n> ℹ️ To manage units in your organization via API, check the [Organizational Units API](https://developers.vtex.com/docs/api-reference/organization-units-api#overview)."}