Organization-level authors

Last updated: Nov 9, 2026

Role required: Admin, Customer Manager or Resourcer.

Currently, Organization Managers can access the organization-level Authors section in read-only mode.

The Authors section of your organization shows the mailmap with your contributors. A mailmap is a file that organizes and unifies the different email addresses and names of contributors. It is useful when contributors used more than one email address or name over time. With the mailmap, you see all their contributions under one name and email address.

We also invite you to read about the group-level authors.

Understand the Authors section

The organization-level Authors section shows a table. Each row is an author, that is, a contributor to the repositories of your organization. These fields identify each author:

Author name: The canonical name, that is, the primary or preferred name of the contributor
Author email: The canonical email, that is, the primary or preferred email address of the contributor

Enter Authors section on the Fluid Attacks platform

Because contributor information can change, each author can have more than one alias. An alias is a different name or email address of the same contributor. To see the aliases of an author, expand the row of the author.

Create alias on the Fluid Attacks platform

For example, a mailmap file has these entries:

Alice Garcia <[email protected]> Alice Garcia <[email protected]>
Alice Garcia <[email protected]> Alice J Garcia <[email protected]>

This is how these entries show in the Fluid Attacks Authors section:

See mailmap entries on the Fluid Attacks platform

Mailmap rules

When you document the mailmap, obey these rules:

Use the email address of the provider, not the one of the client. For example, use <[email protected]> over Eduardo Garcia <[email protected]> or EduardoGarcia <[email protected]>.
By default, do not map a non-corporate email such as userdeveloper <[email protected]>.
To map a non-corporate email to a corporate email, you must have a written request from the client.

Authors section functionalities

Create author

To create an author, click Create author. Then, type the name and email of the author. When you create an author, the platform automatically creates an alias with the same details. If necessary, you can update this alias subsequently.

Create a mailmap entry on the Fluid Attacks platform

(a) Each author within an organization must have a unique email address.

(b) To add more names or email addresses to an existing author, create aliases. Do not create new authors.
(c) With unique emails, it is easier to find authors with the search bar or filters.

Update author

To update an author, do these steps:

Select the checkbox of the author to update.
Click Author configuration.
Select Update author.
Change the name and email of the author in the pop-up window.
Click Update author to apply the changes.

Delete author

To delete an author, do these steps. You can delete only one author at a time.

Select the checkbox of the author to delete.
Click Author configuration.
Select Delete author.
In the pop-up window, click Delete author.

When you delete an author, the Fluid Attacks platform also deletes all the aliases of that author.

Set author as alias

With this function, you can merge two authors into one author with all their contribution history. To set an author entry as alias, do these steps:

Select the checkbox of the author to merge.
Click Author configuration. Then, click Set author as alias.
In the form, type the email of the target author, that is, the author to merge with the selected author.
Click Set author as alias. The selected author and all their aliases become aliases of the target author.

The screenshot above shows a caution icon next to the author email. This icon means that one or more domains of the alias emails are different from the domain of the author email.

Create alias

To create an alias for an author, do these steps:

Find the author. Then, expand their row.
Click Create alias in the expanded row.
In the pop-up window, type the alias name and email address.
Click Create alias.

Update alias

To update an alias, do these steps:

Select the checkbox of the alias to update.
Click Alias configuration. Then, select Update alias.
Update the alias details.
Click Update alias.

At this time, you can search only for authors. To find an alias, you must know the details of its author. Then, use the search bar or filters to find that author.

Delete alias

To delete an alias, do these steps. You can delete only one alias at a time.

Select the checkbox of the alias to delete.
Click Alias configuration. Then, click Delete alias.
In the pop-up window, click Delete alias.

Set alias as author

With this function, the alias information and the author information change places. The previous alias information becomes the primary identifier of that contributor.

Select the alias entry that changes places with the author entry.
Click Alias configuration. Then, select Set alias as author.
Click Set alias as author.

Create author from alias

You can select an alias and change it into an author. Do these steps:

Select the alias entry to change into an author entry.
Click Alias configuration. Then, select Convert alias to new author.
In the confirmation window, if you want, select the related aliases to move to the new author.
Click Convert aliases to new author.

Filter authors

To limit the information that you see, use the filter button. You can filter by author name, author email, alias name, and alias email.

Find filters in Authors

Apply filter

Organization-level authors

On this page