Users and Licenses

Introduction

The Users & Licenses page in the LocalStack Web Application allows workspace administrators to manage workspace memberships and assign licenses.

To access this page:

1. Click your name or organization’s name in the top-left corner of the dashboard.
2. Go to Settings → Users & Licenses under the Administration section.

Member Roles

Each member of a workspace is either a Workspace Admin or a Workspace Member. The role determines which parts of the workspace they can access and manage.

The table below summarizes what each role can do:

Action	Workspace Admin	Workspace Member
Invite new members	✅	❌
Remove members from workspace	✅	❌
Assign or unassign licenses	✅	❌
Change member roles (e.g., promote to Admin)	✅	❌
Configure advanced permissions	✅	❌
Access Auth Tokens	✅	✅
Use assigned LocalStack licenses	✅	✅

Note

Admins manage the overall pool of licenses for the workspace. Each member is still responsible for configuring their own local environment to use their Auth Token.

Key differences

• Administrative control: Only Admins can open the Administration section of Settings to manage workspace membership and the license pool.
• License management: Admins distribute available licenses from the subscription plan to specific members through the Users & Licenses dashboard.
• Role management: Admins can switch any other member between Admin and Member.

Managing Members

Inviting Members

To invite someone to your workspace:

• Click Invite Members.
• Enter the email of the person you want to invite.
• Check the option to automatically assign a license (optional).
• Send the invite.

If the invitee does not have a LocalStack account, they will receive an email to create one.

Note

Only workspace admins can invite members and manage license assignments.

Removing Members

To remove a member from the workspace:

• Click the ⋯ menu at the right of their row.
• Select the option to remove them from the workspace.

You can re-invite them anytime. You can’t remove yourself, and some members can’t be removed from this page. See Restrictions.

Managing Roles and Permissions

Use the ⋯ menu at the right of a member’s row to view and edit their role.

• Set them as Admin or Member
• Configure advanced permissions if available

Tip

To let a member manage other members without making them an admin, give them the Update Team Members or Delete Team Members permissions. They also need the View Team Member Details and View Organization Subscriptions permissions to open the Users & Licenses page.

Restrictions

To keep your workspace safe, these rules apply to everyone who manages members, including admins:

• Your own membership: You can’t change your own role or permissions, or remove yourself. Ask another admin to do it.
• Higher roles: Members who can manage other members can’t change or remove admins, and can’t make anyone an admin.
• Permissions you don’t have: You can only give a member a permission that you have yourself. You can remove any permission.
• SCIM-managed members: If SCIM is enabled, members added through SCIM show a SCIM badge. Your identity provider decides who is in the workspace, so you can’t remove these members here. If a member’s role comes from a SCIM role group, you can’t change their role here either. You can still edit their permissions.

Because of these rules, nobody can demote or remove the last admin of a workspace from this page.

When an action isn’t available, it’s greyed out in the ⋯ menu. Hover over it to see why.

Managing Licenses

Licenses are part of subscription plans and are shown in the License column of the members list.

• To assign or change a license: Click directly on the license name for a member to open the license dropdown.
• To unassign a license: Select the no-license option from the same dropdown.
• A license can be reassigned at any time.

Changes apply immediately and don’t require user action.