MAPTOPLAY

Core Concepts · 8 min read

Teams

How to create, select, manage, and delete teams, including member roles, tier limits, avatars, inactive teams, and provider credentials.

What teams control

A team is the top-level workspace for MapToPlay. Every workspace, project, processing task, asset, export, saved provider credential, and billing limit is scoped to a team. Before you create or open a project, the active team in the dashboard header determines which data you are working with.

When your account is created, the platform creates an initial team and makes you the owner. You can create additional teams from the Teams page, but free-team activation is limited: after your active free team is used, additional free teams may be created as inactive draft teams until you upgrade or free capacity.

If a team is inactive, team-level content may still be visible, but creation actions such as adding workspaces or projects are blocked until the team is active again.

Open and select a team

Open Dashboard -> Teams to manage teams you belong to. The left column lists your teams and includes filters for active/inactive status plus search by name, role, tier, or description. Selecting a team in this list opens its management panel.

The Teams page selection is also connected to the active team context used elsewhere in the dashboard. Workspaces and projects are loaded for the currently active team, so check the header team picker before creating anything important.

  • Use the Active only and Inactive only filters when a team appears to be missing.
  • Use search when you belong to many teams; it matches team name, your role, tier, and description.
  • The summary panel shows total, shown, active, and inactive team counts for your current filter.

Create a team

Click New team on the Teams page. Enter a team name and submit the dialog. The new team is created with you as owner. Team creation only asks for a name; description, avatar, members, credentials, and other details are configured after creation.

If you already own the maximum number of active free teams, the new team is created as an inactive draft when draft capacity is available. If the inactive draft limit is reached, the API rejects the creation and asks you to delete an inactive draft team first.

  • Team name is required.
  • The default tier is Free.
  • New teams start with incognito mode disabled.
  • The creator is added as owner immediately.

Add members and assign roles

Select a team, then use the Team members form. Enter a username or email address, choose a role, and click Add member. The user must already have a MapToPlay account. If the user is already on the team, the platform returns a duplicate-member error.

Member limits are shown above the form. If the current tier has a maximum user count and the team is already at that count, the add-member button is disabled. Owners and admins can add members; lower roles can view the member list but cannot manage it.

The backend protects owner removal: you cannot demote or remove the current owner directly. Transfer ownership to another member first.
  • Owner: full control of the team. Assigning owner to another member transfers ownership and demotes existing owners to admin.
  • Admin: can manage team settings, members, workspaces, and team content.
  • Editor: intended for creating and editing project content.
  • Viewer: intended for browsing team content without changing it.

Rename, avatar, and deletion

In the selected team panel, owners and admins can rename the team, upload an avatar, remove the avatar, or delete the team. Avatar uploads accept PNG, JPEG, and WebP images; the image is cropped before upload and must pass the managed image size limit.

Deleting a team is destructive. The confirmation dialog requires the word DELETE, then the backend removes the team, its workspaces, its projects, project assets, project upload objects, and stored team/workspace avatars.

  • A team cannot be deleted while any project in the team has a running task.
  • Deleting a team also deletes every workspace and project inside it.
  • Only owners and admins can rename, delete, upload avatars, remove avatars, add members, change roles, or remove members.

Provider credentials

The right side of the Teams page contains the provider credentials panel for the selected team. Credentials are stored at team scope so project creation and reprocessing can reuse them when a data provider requires a token or username/password.

When choosing provider source data, DTM providers with credential requirements can use a saved team credential instead of entering credentials manually. This is why provider credentials live on the team, not inside a single project.

Only users who can manage the selected team can manage its saved provider credentials.