Skip to main content

Teams v1 (pre 2025)

Before you begin

It's a good idea to understand what Teams on Middleware are.
Read the documentation here before you continue.

Joined Middleware in 2025 (or later)? Go here.​

Is this the right page for me?

If your UI looks like this, you're in the right place:

Teams v1 preview

If not, please visit Teams v2 instead.

If you're interested in creating multiple teams in one go, refer to this page.

If you're looking to create one team at a time, please continue...

Creating a team requires several steps (later simplified in v2)

Initial setup​

  1. Visit https://app.middlewarehq.com/teams
  2. Click “Create a new team”
    Create a new team
    Click to expand image for "Create a new team"
  3. Specify a team name
    Specify team name
    Click to expand image for "Specify team name"
    1. At this point, if you have other users added to Middleware, you can select them in the right pane to add as a manager. You should find your own user here at least.
      Select manager
      Click to expand image for "Select manager"
    2. If you don't find your needed user, you can skip this step for now.
  4. Click “Add”
    Click Add
    Click to expand image for "Click Add"
  5. A team will be created, with no members, repos, projects, or incident services mappings.
    Team Created
    Click to expand image for "Team Created"
  6. Next steps:
    1. Manager Setup
    2. Adding/Updating Members
    3. Mapping Integrations Data to Teams
      1. Mapping Repos
      2. Mapping Projects
      3. Mapping Incident Services

Manager Setup​

If the manager is already present in Middleware​

  1. Click the edit button on a Team card.
    Edit Team Card
    Click to expand image for "Edit Team Card"
  2. Ensure the modal says “Selecting (Manager)”
    Modal for Manager Selection
    Click to expand image for "Modal for Manager Selection"
  3. Just click on the new manager
    Select New Manager
    Click to expand image for "Select New Manager"
  4. Click “Save”, and you're done!
    Save Manager
    Click to expand image for "Save Manager"

If the manager is NOT present on Middleware​

You can ask them to log in, and then follow these steps.

Otherwise, add them to Middleware:

  1. Click on “Manage Users” in the header.
    Manage Users
    Click to expand image for "Manage Users"
  2. Click “Add a new user” in the overlay that opens.
    Add New User Overlay
    Click to expand image for "Add New User Overlay"
  3. Fill in the required fields, and click “Add”.
    User Added
    Click to expand image for "User Added"
  4. Close the overlay, such that you're back on the Teams UI again.
  5. Finally, follow these steps.

Adding/Updating Members​

Adding members to the team​

  1. Select the team you want to add members to. Selected teams will appear highlighted.
    Select Team
    Click to expand image for "Select Team"
  2. Click this big button that says “Click to add member”
    Add Member Button
    Click to expand image for "Add Member Button"
  3. Here, you can either search for an existing user to add to this team, or add details for a new user altogether.
    If you add details for a user that might already exist, it'll simply use the existing user as long as the email is identical - without creating duplicates.
    Search/add user
    Click to expand image for "Search/add user"
  4. Clicking an existing user in the right section, or clicking “Add” will add that user to the team.

Removing members from the team​

Just click the cross on the User card, from the team members list.

Remove Member
Click to expand image for "Remove Member"

Mapping Integrations Data to Teams​

About accesses​

Middleware requires you to link various integrations to present you a full-picture scenario of your teams' planning, execution, and delivery processes.

Due to limitations in the kind of configurable access controls that many third party integrations offer, it's often not possible for us to request the limited nature of access that we actually need - which is usually only read-only access to metadata level things.

As such, actually seeing your insights on Middleware is a two step process.

  1. Tell Middleware which repos/projects/incident services you'll like to share data of.
  2. Map those selected repos/projects/incident svcs. to respective teams.

Prerequisite step before you proceed​

  1. Visit https://app.middlewarehq.com/integrations
  2. Link any of your desired integrations
    Link Integration
    Click to expand image for "Link Integration"
  3. Most integrations would have a “Manage” button. Click that.
  4. You would be directed to a screen where you can select various repos/projects/incident svcs. to sync with Middleware, to subsequently map with various teams.

Mapping Repos​

  1. Go to teams: https://app.middlewarehq.com/teams
  2. Click on the team you want to do this for.
  3. Click on the Repos tab.
  4. You should see a header saying “Repos linked to your org”
  5. Select the repos present in that section by clicking on the “<<” icon.

Here's a visual example, explaining the order of clicks:

Mapping Repos
Click to expand image for "Mapping Repos"

Mapping Projects​

  1. Go to teams: https://app.middlewarehq.com/teams
  2. Click on the team you want to do this for.
  3. Click on the Projects tab.
  4. You should see a header saying “Projects linked to your org”
  5. Select the projects present in that section by clicking on the “<<” icon.

Here's a visual example, explaining the order of clicks:

Mapping Projects
Click to expand image for "Mapping Projects"

Mapping Incident Services​

  1. Go to teams: https://app.middlewarehq.com/teams
  2. Click on the team you want to do this for.
  3. Click on the Incident Services tab.
  4. You should see a header saying “Services linked to your org”
  5. Select the services present in that section by clicking on the “<<” icon.

Here's a visual example, explaining the order of clicks:

Mapping Incident Services
Click to expand image for "Mapping Incident Services"

What's next?​

If you've added members to your teams, there's one more thing to do before you can see their dev-specific insights.
Go to “Linking Users” documentation for details.

Else you can just wait for 5-10 minutes for your data to be ready, and then see your team or org-level insights on any of the other analytics screens.