--- description: "Efficiently manage the organization mailmap in the Authors section to keep all contributor information orderly on the Fluid Attacks platform." keywords: "authors, aliases, organization mailmap, author email, author name, contributor information, Fluid Attacks platform, Fluid Attacks documentation" other: private: false title: Manage your organization's authors --- # Manage your organization's authors import { Image } from "@/components/image"; > [!NOTE] > > A Fluid Attacks [Admin](https://help.fluidattacks.com/portal/en/kb/articles/understand-roles#Admin), [Customer Manager](https://help.fluidattacks.com/portal/en/kb/articles/understand-roles#Customer_Manager) or [Resourcer](https://help.fluidattacks.com/portal/en/kb/articles/understand-roles#Resourcer) role is required. > [!TIP] > > **Note:** Currently, [Organization Managers](https://help.fluidattacks.com/portal/en/kb/articles/understand-roles#Organization_Manager_role) can access the organization-level Authors section in read-only mode. Your organization's Authors section displays the mailmap containing your contributors. A mailmap is a file that helps organize and unify different email addresses and names used by contributors. It is useful when contributors have used multiple email addresses or names over time, allowing you to show a consistent view of their contributions. > [!TIP] > > To read about the group-level Authors section, go to [Invite contributing developers](https://help.fluidattacks.com/portal/en/kb/articles/invite-contributing-developers). ## Understand the Authors section The organization-level **Authors** section presents a table where each row corresponds to an author (a contributor within your organization's repositories). Each author is identified by the following: - **Author name:** Also known as canonical name, the primary or preferred name of the contributor - **Author email:** Also known as canonical email, the primary or preferred email address associated with the contributor Enter Authors section on the Fluid Attacks platform

Enter Authors section on the Fluid Attacks platform

To accommodate variations in contributor information, each author can have multiple aliases linked to them. An alias represents an alternative name or email address used by the same contributor. Expand an author's row to view their associated aliases. Create alias on the Fluid Attacks platform

Create alias on the Fluid Attacks platform

Take a mailmap file with the following entries: ``` Alice Garcia Alice Garcia Alice Garcia Alice J Garcia ``` These entries look like this in Fluid Attacks' Authors section: See mailmap entries on the Fluid Attacks platform

See mailmap entries on the Fluid Attacks platform

## Mailmap rules These are the rules that must be followed at the time of documenting the mailmap: 1. Use the email address of the provider over the one of the client. - Use `<[eduardo.garcia@company.com](mailto:eduardo.garcia@company.com)>` over `Eduardo Garcia` `<[eduardo.garcia@corporation.com](mailto:eduardo.garcia@corporation.com)>` or `EduardoGarcia` `<[egarcia@institute.edu.co](mailto:egarcia@institute.edu.co)>`. 1. Do not map by default a non-corporate email such as `userdeveloper <[user123@gmail.com](mailto:user123@gmail.com)>`. 1. In order to map a non-corporate email to a corporate one, written request from the client is required. ## Authors section functionalities ### Create author To create an author, click the **Create author** button and enter the author's name and email. After creating an author, an alias with the same details is automatically created. You can [update this alias](https://help.fluidattacks.com/portal/en/kb/articles/manage-organization-authors#Update_alias) later if needed. Create a mailmap entry on the Fluid Attacks platform

Create a mailmap entry on the Fluid Attacks platform

> [!TIP] > > **Notes:** > > - Each author within an organization must have a unique email address. > - To add additional names or email addresses associated with an existing author, create aliases instead of new authors. > - The unique email constraint simplifies searching for authors using the search bar or filters. ### Update author To update an author, follow these steps: 1. Select the author whose information you want to update by clicking their corresponding checkbox. 1. Click on **Author configuration**. 1. Select the **Update author** option. Update author on the Fluid Attacks platform

Update author on the Fluid Attacks platform

1. Modify the author's name and email in the pop-up window. Change author information on the Fluid Attacks platform

1. Click on **Update author** when you are done to apply the changes. ### Delete author Follow the steps below to delete an author. You can only delete one author at a time. 1. Click the checkbox next to the author you want to delete. 1. Click on **Author configuration**. 1. Select the **Delete author** option. Delete author from the Fluid Attacks platform

Delete author from the Fluid Attacks platform

1. Confirm deletion in the pop-up window by clicking **Delete author**. Confirm author deletion on the Fluid Attacks platform

1. Click on **Update author** when you are done to apply the changes. > [!CAUTION] > > Deleting an author also deletes all associated aliases. ### Set author as alias This feature allows you to merge two authors into one, consolidating their contribution history under a single author. To set an author entry as alias, do the following: 1. Select the author you want to merge by checking their corresponding checkbox. 1. Click on **Author configuration** and then on **Set author as alias**. Set alias on the Fluid Attacks platform

1. In the form, enter the target author's email (the author with which you want to merge the selected author). Merge authors on the Fluid Attacks platform

Merge authors on the Fluid Attacks platform

1. Confirm the merge by clicking **Set author as alias**. The selected author and all their aliases are then all added as aliases under the target author. View merged aliases on the Fluid Attacks platform

View merged aliases on the Fluid Attacks platform

> [!TIP] > > **Note:** A caution icon next to the author email, as shown in the screenshot above, signifies that one or more domains in alias email do not match that of the author email. ### Create alias Follow these steps to create an alias under an author: 1. Locate the author you want to add an alias to and expand their row. 1. Click the **Create alias** button found in the expanded row. Create an alias on the Fluid Attacks platform

Create an alias on the Fluid Attacks platform

1. In the pop-up window, enter the alias name and email address. Add alias information on the Fluid Attacks platform

1. Click on **Create alias** to confirm. ### **Update alias** To update an alias follow these steps: 1. Select the alias you want to update by clicking its corresponding checkbox. 1. Click the **Alias configuration** button and select the **Update alias** option. Update alias on the Fluid Attacks platform

Update alias on the Fluid Attacks platform

1. Update the alias details. Change alias details on the Fluid Attacks platform

1. Click on Update alias to confirm. > [!TIP] > > **Note:** Currently, search functionality is limited to authors. To locate a specific alias, you need to know the details of its associated author and use the search bar or filters to find that author. ### Delete alias Below are the steps to delete an alias. You can only delete one alias at a time. 1. Select the alias you want to delete by clicking its corresponding checkbox. 1. Click on **Alias configuration** and then on the **Delete alias** option. Delete alias on the Fluid Attacks platform

Delete alias on the Fluid Attacks platform

1. Confirm alias deletion in the pop-up window by clicking on **Delete alias**. Confirm alias deletion on the Fluid Attacks platform

### Set alias as author This functionality allows you to swap places between alias information and author information, making the former alias information the primary identifier for that contributor. 1. Select the alias entry that you would like to swap places with the author entry. 1. Click on **Alias configuration** and select **Set alias as author**. Set alias as author on the Fluid Attacks platform

Set alias as author on the Fluid Attacks platform

1. Click **Set alias as author** to confirm the change. Confirm alias to author conversion on the Fluid Attacks platform

### Create author from alias You can choose an alias and convert it to an author. These are the steps to achieve it: 1. Select the alias entry that you want to transform into an author entry. 1. Click on **Alias configuration** and select **Convert alias to new author**. Find option to convert alias to author on the Fluid Attacks platform

Find option to convert alias to author on the Fluid Attacks platform

1. In the confirmation window, indicate, if you wish, which related aliases to migrate to the new author. Migrate aliases to author on the Fluid Attacks platform

Migrate aliases to author on the Fluid Attacks platform

1. Click on **Convert aliases to new author** when you are done. ### Filter authors To limit the information displayed to you, use the filters button (

). This feature lets you filter by author name, author email, alias name, and alias email. Filter authors on the Fluid Attacks platform

Find filters in **Authors** Apply filters to authors on the Fluid Attacks platform

Apply filter