Account Management

March 18, 2025 · Last updated on July 30, 2025

How to manage multiple teams or projects using the Sub-Workspaces

# Sub-spaces

Stay organized across multiple workspaces

Managing multiple teams or projects within HeyGen can get complicated, especially when different teams need different levels of access. That’s where Sub-workspaces come in! With this feature, you can create separate environments, assign members, and control billing or API settings effortlessly.

What’s covered in this guide

In this tutorial, we’ll walk you through:

What are Sub-workspaces?

Navigating to Sub-workspaces

Creating a Sub-workspace

Managing members and permissions

Moving avatars to Sub-workspaces

What are Sub-workspaces?

Sub-workspaces are separate environments within a HeyGen account that allow for better team and project management. Each Sub-space has its own members, permissions, and settings.

Sub-workspaces help agencies and enterprises control access, billing, and API usage across different teams or clients. Sub-workspaces can be configured to share or separate resources such as billing, avatars, API keys and templates.

Navigating to Sub-workspaces

From your dashboard, click on your name, and go to ‘Space Settings’, from there you can navigate to ‘Members.’ You’ll see the ‘Sub-workspaces’ option in this menu.

Creating a Sub-workspace

To create a new Sub-workspace, click on “create Sub-workspace”

Begin by entering a name for your Sub-workspace and an image of your choice.

Next up, add an email to invite new members. Once you do that, you can select their role in the space:

Super admin: has full permissions, including adding new users, managing access, and handling purchases

Developer: creates content and has API access, ideal for advanced integrations

Creator: has permission to create avatars, videos, and voices

Viewer: can view content but not make changes

In ‘Settings and Permissions,’ you can configure key settings:

Manage subscription: if toggled on, the Sub-workspace will manage its own subscription and will not inherit or use up any quota or Video Avatar Slots of the Parent space. Note that toggling this on will also enable the Sub-workspace owner to create additional Sub-workspaces.

View API settings: if toggled on, the sub-workspace will be able to access API settings and use separate API keys. Each Sub-space has its own API key. The ‘Usage History’ tab on the ‘API Settings’ page for each Sub-space will only show usage for the API key for that Sub-space. This will allow the Parent space to easily track API usage per sub-space

Once you are done, click on ‘Create new sub-workspace’ to finalize the sub-workspace.

Managing members and permissions

Once a Sub-workspace is created, all seats available in the parent space will be allocated accordingly.

If you invite members, seats will be taken up based on the available quota, once the limit is reached, no additional members can be added without removing an existing one.

When logged into a typical Sub-workspace, subscription settings are not visible.

Moving avatars to Sub-workspaces

Parent spaces have the ability to move avatars from their space to their connected Sub-workspaces. To do this, navigate to the 'Avatars' tab in the left navigation.

Next, click the three dots in the top right corner of the avatar you'd like to move, select 'Share to other spaces,' and choose the desired Sub-workspace to move this to.

Sharing Brand Kits and Templates Across Sub-workspaces

Enterprise spaces can now share brand kits and templates with their connected Sub-workspaces. To do this, navigate to the left-hand menu and select either 'Brand Kits' or 'Templates.'

Next, click the three dots in the top right corner of the brand kit or template you'd like to share, select 'Share to Sub-workspace,' and choose the desired Sub-workspace.

Once shared, the recipient Sub-workspace will have view-only access to the asset. They can create a copy to edit, but any changes made by the original sharer will not be reflected in their copy.

Additionally, private avatars and voices will be replaced with public options from the platform when using shared templates.

Recap

And that’s it! With Sub-workspace, you can easily manage teams and projects within HeyGen while maintaining control over access and billing.

What we covered:

What are Sub-workspaces?

How to navigate and create Sub-workspaces

Adding and managing members

Managing members and permissions

Moving avatars to Sub-workspace

Looking forward to seeing how you use Sub-workspace to streamline your workflow!

Comments (0)

Popular

Table Of Contents