# Teams and Groups
# Team
All internal users of the platform make up the team, and each member can have a specific role to make the most of the system.
In this section, you can create, edit, and disable users of the platform.
# Create user
To create an internal user, follow these steps:
- From the main menu, click on Settings.
- Select Team.
- Click on New Team Member.
- Fill in the first name, last name, username, email, password, and password confirmation fields. With Generate strong password, the platform fills in both password fields for you.
- Click Save.
The username can only contain letters A to Z (uppercase or lowercase), numbers, and the symbols | # @ % . _ - ' + /. Spaces and other characters are not allowed.
Tip
The new member always receives an email with their email address, their username, and the link to access the platform. The Include password in user email checkbox is checked by default and adds the password to that email; uncheck it if you'll give it to them through another channel.
# Edit user
Within the user edit screen, platform administrators have access to the following windows:
- Activity: Shows the history of all actions performed by the user.
- Access: Defines which applications the user can access and their account role. It also shows the groups they belong to: Add group adds them to another group and Remove group removes them from one.
- API access: Generate access tokens to use the Modyo administrative API. Each token is created for one of the applications registered in Settings > API access; if there are none, you have to create one first. See Bearer token.
- Edit: Modify user data such as name, email, and password.
- Devices: Shows a list of all devices where the user has an active session. It displays data such as browser, operating system, last login, and IP address. Here, in addition, you can remotely log out for each device. When a team member signs in from a device they had not used before, Modyo sends them a notice by email; see Sign-in notice from a new device.
Attention
When you set or change another team member's password from Edit, the platform marks that password as pending change and immediately revokes all their active sessions: the member is logged out on every device and, on their next login, must set a new password before they can browse the panel. The same happens when you create a team member with a password. Let them know beforehand.
Usernames created in earlier versions
Users created before the character validation existed may have usernames that are no longer allowed (for example, containing spaces). While the username does not meet the validation, any update to that user will fail — including administrative actions such as removing their authenticator (2FA), which may show a success message without actually taking effect. Before performing actions on one of these users, correct their username first.
# Disable or enable user
Disabling a team member removes their access to the platform without deleting them. To do so, follow these steps:
- From the main menu, click on Settings.
- Select Team.
- In the member's row, in the Actions column, click Disable and confirm.
You can also disable them from their profile, in the three-dot menu next to their name.
When you disable them, the platform immediately closes all their active sessions. While they are disabled, they can't sign in or use their API access tokens.
To give them access back, use Enable from the same places. In the Team list, disabled members appear when you choose Disabled in the Status filter.
To disable or enable a member you need the Admin Team permission. The account owner can't be disabled.
# Groups
Groups allow you to streamline access control to the different Modyo contexts. You can assign a default role to a context (account, space, realm, or site) for multiple users at the same time and then that group of users to different contexts. This allows all users to obtain the group role in the corresponding context.
In addition, from the Groups block of the Access tab in each team member's profile, you can add the user to an existing group or remove them from one.
Tip
All users who belong to a group will have the group's role. If they also have an individually assigned role, or belong to several groups, in each context they get the sum of the permissions of all those roles, minus those of the applications they don't have enabled.
# Create a group
To create a group, follow these steps:
- Click on Settings.
- Click on Groups.
- Click New Group.
- Type the name of the group and select theGroup Role.
- Select from the drop-down menu under Add Users, the users that will be part of this group.
- Click Create.
Once a group is created, you can view it in the Groups panel. In addition, when editing a user, you can add them or, if they are already part of that group, delete them.
# Roles
You can apply roles in the different modules to customize the experience of your work team. Each role applies in a specific way to a particular module. For example, you can select the administrators of a space or the members who can interact with the CLI somewhere.
Modyo has 15 default roles with different functions for each context, allowing you to distribute and control access to the different sections of each context of the platform.
Each role has the name you see in the panel and a technical name, the key, shown in parentheses in the lists below. The key is the value returned by the roles API and the one you use when assigning roles through the API.
# Default Roles
Modyo assigns default roles depending on the context or section in which they are used.
The default roles that exist, depending on the context, are:
# Account-level roles
- Default user (
account_user): It carries the View Global Variables and Admin Insights permissions. To work in a site, space, or realm, the member must be invited to that context with one of its roles. - Default admin (
account_admin): It carries the Manage Channels, Manage Content, and Manage Customers permissions, which let it administer every site, space, and realm without being invited to them, and create new ones. It also carries Admin Global Variables, Admin Global Snippets, Admin Locks, View Activity Logs, and Admin Insights. It doesn't have Admin Settings: in Settings it only accesses Activity logs. - Full admin (
account_owner): Has all existing permissions and can access all contexts without needing to be invited to them.
# Site-level roles
- Site Viewer (
site_viewer): Can view the site's pages, menus, templates, and widgets and the global variables, see differences between versions, and leave comments. Can also access the synchronization view and see pending changes to synchronize. However, this role is not authorized to perform any action that implies a change in the platform. - Site Developer (
site_developer): Creates and edits pages, menus, widgets, and templates, and can restore a previous version of them (rollback). It can only view global variables. Cannot publish, delete, or edit the configuration. - Site Developer CLI (
site_developer_cli): Has the same permissions as Site Developer; in addition, can interact with modyo-cli. - Site Reviewer (
site_reviewer): Has all the permissions of the Site Admin role, except Admin Settings Web App and Admin Synchronizations: cannot edit the site settings or access its synchronizations. - Site Admin (
site_admin): Has all the permissions at the level of a site, but cannot create new sites.
# Space-level roles
- Space Viewer (
space_viewer): This role allows you to view the contents of a space, see differences between versions, and leave comments. Access is limited to viewing and participating through comments; you cannot make modifications to the content or take actions that affect the configuration. - Space Writer (
space_writer): Creates and edits entries, and manages the space's assets and categories, including deleting them. Cannot publish or delete entries, perform rollback, or edit the configuration. - Space Editor (
space_editor): Creates, edits, publishes, and reviews entries, can perform rollback, and manages the space's types, categories, and assets. Unlike Space Admin, cannot delete, clone, or bulk edit entries, or edit the space configuration. - Space Admin (
space_admin): This role has all the permissions at the space level, but it cannot create new spaces. Can create and delete assets.
# Roles by realm
- Realm User (
realm_user): It carries the View User, Admin Campaigns, Admin Campaign Templates, Admin Forms, Admin Segments, and View Payment Orders permissions. It can view the realm's users, but cannot create, edit, or delete them. - Realm Admin (
realm_admin): Can access all the configurations and sections of the realm. In addition, can add and remove users and team members, delete the realm, and create and sync its stages with the Admin Stages and Admin Synchronizations permissions. - Realm Viewer (
realm_viewer): A read-only role over Customers. It carries the View User, View Segments, View Events, View Payment Orders, View Campaign Templates, View Forms, View Campaign Deliveries, and View Synchronizations permissions. It cannot create or modify anything inside the realm.
Tip
In accounts created before version 10.2.2, Realm Admin and Realm Viewer don't automatically get Admin Synchronizations or View Synchronizations: add them to the role if you need them. See Stage permissions.
# Edit and delete the default roles
Full admin is the only default role the platform marks as non-editable: you cannot rename it, change its permissions, or delete it. This does not limit its permissions, which are still all of them. The other 14 default roles behave like any custom role and you manage them from Settings > Roles:
- To change its name or its permissions, click on the role name in the list.
- To delete it, in the Actions column of its row choose Delete and confirm.
Attention
A role can only be deleted if it is not assigned to anyone. If any team member or group has it assigned in any context, the platform blocks the deletion and shows an error. Reassign those members and groups first, and only then delete the role.
# Custom roles
Custom roles allow you to create profiles with unique access and permissions, combining existing roles or configuring them according to the specific needs of your organization.
Tip
Custom roles are available from version 10.1 onwards.
# Create custom roles
To create a custom role, select the New Role button and define its scope. This will assign permissions depending on your selection:
- Organization: the role will have access to all Modyo modules and its scope will be global.
- Channels: the role will have access only to the Channels module.
- Customers: the role will have access only to the Customers module.
- Content: the role will have access only to the Content module.
When you create a new role or select an existing one, you will be able to view and modify all its associated permissions and accesses. If you select the All option, you will automatically assign all permissions to the role.
Some permissions include others: when you check one, the platform also checks the ones that permission needs to work. The most granular case is origination submissions, with three tiers of detail visibility; review submission visibility permissions.
To keep the changes, press the Save button.
# Access to applications
Beyond the role, each team member has a switch per application that decides which modules they see in the panel. There are four applications you can enable or disable: Content, Channels, Customers, and Insights.
The Applications access block appears in two places:
- In the Access tab of a team member, above the role selector.
- When creating or editing a group, above the Group Role field.
Access is additive between the member's own settings and their groups: if any of the groups they belong to has an application enabled, the member sees it, even if that checkbox is off in their individual settings. To take an application away from them you have to turn it off in their settings and also in every group that grants it.
Disabling an application does not remove the member's role: the role stays assigned, but the platform subtracts that application's permissions, so they stop seeing that section of the panel even if their role would grant it.
Tip
Some checkboxes are ticked automatically and left disabled depending on the selected account role. In the Access tab of a member, the account owner has all four applications fixed and the Default admin role fixes Content, Channels, and Customers. In the group form, Default admin fixes all four.
# Assign one role per account
To assign a role in the account context, follow these steps:
- Go to the “Team” section on the Modyo platform.
- Click on the profile of the user whose role you want to change.
- Go to the “Access” tab.
- Under Role, select the account role you want to assign to the user. Site, space, and realm roles are assigned from the team of each one.
- Click the Save button to confirm the changes.