Managing multiple teams or projects within HeyGen can get complicated, especially when different teams need different levels of access. That’s where Sub-spaces 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:

1. What are Sub-spaces?
2. Navigating to Sub-spaces
3. Creating a Sub-space
4. Managing members and permissions
5. Moving avatars to Sub-spaces

What are Sub-spaces?

Sub-spaces 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-spaces help agencies and enterprises control access, billing, and API usage across different teams or clients. Sub-spaces can be configured to share or separate resources such as billing, avatars, API keys and templates.

Navigating to Sub-spaces

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

Creating a Sub-space

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

Begin by entering a name for your Sub-space 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:

1. Super admin: has full permissions, including adding new users, managing access, and handling purchases
2. Developer: creates content and has API access, ideal for advanced integrations
3. Creator: has permission to create avatars, videos, and voices
4. Viewer: can view content but not make changes

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

1. Manage subscription: if toggled on, the Sub-space 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-space owner to create additional Sub-spaces.
2. View API settings: if toggled on, the sub-space 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-space’ to finalize the sub-space.

Managing members and permissions

Once a Sub-space 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-space, subscription settings are not visible.

Moving avatars to Sub-spaces

Parent spaces have the ability to move avatars from their space to their connected Sub-spaces. 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-space to move this to.

Recap

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

What we covered:

1. What are Sub-spaces?
2. How to navigate and create Sub-spaces
3. Adding and managing members
4. Managing members and permissions

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