Skip to content
Arbinel

Teams in comments

Organization owners can show the teams a member belongs to next to that member’s comments in the organization’s repositories. Readers of an issue or pull request then see what part each person plays in it, such as maintainer or security team, rather than only Owner or Member. Forgejo shows none of this, and Arbinel does not show it until an owner turns it on.

  1. Open the organization’s settings at /org/<organization>/settings.

  2. Under Teams in comments, select whose teams to show:

    Option Shows the teams of
    Do not show teams Nobody. This is the default.
    Show the teams of members whose membership is public Members who made their membership public on the organization’s Members page
    Show the teams of all members Every member, including members whose membership is private
  3. Select Update team display.

With the second option, each member decides for themselves by making their membership public or private. The third option reveals that a member with a private membership belongs to the organization.

Each team the poster belongs to gets a label with a team icon after the poster’s role label. The labels show on the issue or pull request description and on every comment. On narrow screens, Arbinel hides team labels along with the role labels, as Forgejo does.

Hovering over a label shows what the team may do in the repository:

  • Members of the owners team are owners of the organization, with full access to all its repositories.
  • An administrator team has administrator access to the repository.
  • Other teams list the repository units they can read or write, such as Code (Write), Issues (Read).
  • A team that the repository is not added to has no access to it.

A label links to the team’s page when the reader can open that page. Site administrators, organization owners, members of an administrator team that covers all repositories, and members of the team itself can open it. For everyone else the label is plain text.

Team labels replace role labels that say the same thing. A poster with team labels does not get the Member label. A member of the owners team does not get the Owner label while the owners team has a label.

The Team labels list in the same section sets how each team’s label shows:

Setting Effect
Highlighted The label uses the accent color and comes before the other labels.
Shown The label looks like the role labels.
Hidden The team gets no label.

The owners team starts as Highlighted, and every other team starts as Shown. Teams created later also start as Shown.

The owners team cannot be renamed. To highlight a team with a name of your choosing instead, set that team to Highlighted and the owners team to Shown or Hidden. When the owners team is hidden, its members show the Owner role label again.

Turning team labels off keeps these settings for the next time you turn them on.