# Project Users

## Project Roles

***

Each user has an Project Role that controls what Tasks they can edit, and what data they can manage inside the Project.

#### Project User roles at a Glance:

| Role               | Permissions Include                                                                                                                                |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Project Admin**  | <p>Everything. Full control over the Project Users, Settings, Assets, Imports, Publishing & Permissions.<br>Can edit all Tasks in the Project.</p> |
| **Project Member** | Can make edits to their own Tasks and add new Users to the project⁠.                                                                               |

<details>

<summary>Project Role Permission Matrix</summary>

<table><thead><tr><th width="354.0625">Data</th><th width="93.2421875" data-type="checkbox">Admin</th><th width="104.26171875" data-type="checkbox">Member</th><th>Notes</th></tr></thead><tbody><tr><td>Create Tasks</td><td>true</td><td>true</td><td></td></tr><tr><td>Edit Tasks</td><td>true</td><td>true</td><td></td></tr><tr><td>Manage Project Settings</td><td>true</td><td>false</td><td></td></tr><tr><td>Manage Project Permissions</td><td>true</td><td>false</td><td></td></tr><tr><td>Add Project Users</td><td>true</td><td>true</td><td>Organisation -controlled</td></tr><tr><td>Manage Project Users</td><td>true</td><td>false</td><td></td></tr><tr><td>Create Teams</td><td>true</td><td>true</td><td></td></tr><tr><td>Manage Integrations</td><td>true</td><td>false</td><td></td></tr><tr><td>Import Tasks via CSV</td><td>true</td><td>true</td><td></td></tr><tr><td>Import Master Schedule </td><td>true</td><td>true</td><td>Members require the <strong>Import Master Schedule</strong> additional permission to access this feature</td></tr><tr><td>Publish the Plan</td><td>true</td><td>false</td><td></td></tr><tr><td>Make Ready</td><td>true</td><td>true</td><td></td></tr><tr><td>Manage Publicly Shared Data</td><td>true</td><td>false</td><td></td></tr><tr><td>Create and Share Views</td><td>true</td><td>true</td><td></td></tr><tr><td>Manage All Views</td><td>true</td><td>false</td><td></td></tr><tr><td>Create &#x26; Manage Folders</td><td>true</td><td>true</td><td>Project-controlled</td></tr><tr><td>Create &#x26; Manage Packages</td><td>true</td><td>true</td><td></td></tr><tr><td>Create &#x26; Manage Labour</td><td>true</td><td>false</td><td></td></tr><tr><td>Create &#x26; Manage Plant</td><td>true</td><td>false</td><td></td></tr><tr><td>Create &#x26; Manage Materials</td><td>true</td><td>false</td><td></td></tr><tr><td>Create &#x26; Manage Subcontractors</td><td>true</td><td>false</td><td></td></tr><tr><td>Create &#x26; Manage Locations</td><td>true</td><td>false</td><td></td></tr><tr><td>Create &#x26; Manage Calendars</td><td>true</td><td>false</td><td></td></tr><tr><td>Create &#x26; Manage Delay Reasons</td><td>true</td><td>false</td><td></td></tr><tr><td>Create &#x26; Manage Blockers</td><td>true</td><td>true</td><td>Project-controlled</td></tr><tr><td>Create &#x26; Manage Tags</td><td>true</td><td>true</td><td>Project-controlled</td></tr></tbody></table>

</details>

## Additional Permissions  <a href="#users" id="users"></a>

***

Additional Permissions allow Project Admins to grant specific capabilities to Project Members without changing their Project Role.&#x20;

Currently the available additional permissions include:

| Permission             | Description                                                           |
| ---------------------- | --------------------------------------------------------------------- |
| Import Master Schedule | Allows a Member to import a Master Schedule and manage imported tasks |

<details>

<summary>Behaviour for Members with Permissions</summary>

Members granted the **Import Master Schedule** permission can:

* Import Master Schedules (XML, XER, and MPP files)
* Move imported tasks from **Unassigned → Backlog → Gantt**

</details>

## Planner Access <a href="#users" id="users"></a>

***

Seperate from their Project Role, Users either have Full or Limited Planner Access - this defines product functionality access.

| Planner Access | Entitlement                                            |
| -------------- | ------------------------------------------------------ |
| Full           | Complete access to all Planner features and View types |
| Limited        | Restricted to List View only and mobile app access⁠    |

Planner access is set per Project, but requires a paid Planner Seat for Full access.

<details>

<summary>Planner Access: Full vs Limited</summary>

<table><thead><tr><th width="429.58203125">Functionality</th><th width="72.41015625" data-type="checkbox">Full</th><th width="102.0859375" data-type="checkbox">Limited</th></tr></thead><tbody><tr><td>Aphex Planner</td><td>true</td><td>true</td></tr><tr><td>Gantt Views</td><td>true</td><td>false</td></tr><tr><td>Board Views</td><td>true</td><td>false</td></tr><tr><td>Map Views</td><td>true</td><td>false</td></tr><tr><td>List Views</td><td>true</td><td>true</td></tr><tr><td>Aphex Mobile (List &#x26; Map)</td><td>true</td><td>true</td></tr><tr><td>Published Versions</td><td>true</td><td>true</td></tr></tbody></table>

</details>

## Managing Planner Access

***

Planner Access can be set to Full or Limited for users whether you’re updating one person, multiple users at once, or inviting someone new.

#### Set Full Planner Access:

Open the Project and click your Project Title in the top left, then `Users`

* **Individual Assignment:**&#x20;
  * Locate a specific User in the table
  * Toggle their Planner Access to <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FrvTcctNRDtoOHaw7U9zU%2FTheme%3DLight%2C%20Size%3DRegular%2C%20State%3DOn.svg?alt=media&#x26;token=d08029bc-cd20-4401-bc69-8ded58cdca38" alt="" data-size="line"> `Full`​
* **Bulk Assignment**:
  * Select multiple Users using the ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FUmk4xHroFcifJzozWIty%2FGrab%20Select.svg?alt=media\&token=2d16c5b8-ca42-4e97-882e-f4bb8c21a5d8) checkboxes
  * Use the multi-select toolbar <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FGl86nA6I40QWttnCAocM%2FFAB%20(1).svg?alt=media&#x26;token=2afcf1e6-a7f2-4a2e-abfd-6671c61d3b3b" alt="" data-size="line"> to turn on Full Planner Access for all selected Users⁠⁠​
* **Adding New Users**:&#x20;
  * When using the Add User flow, you can allocate Full Planner Access during the invitation process by toggling their Planner Access to <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FrvTcctNRDtoOHaw7U9zU%2FTheme%3DLight%2C%20Size%3DRegular%2C%20State%3DOn.svg?alt=media&#x26;token=d08029bc-cd20-4401-bc69-8ded58cdca38" alt="" data-size="line"> `Full`

These same steps can be taken to set Planner Access to <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Frg1G65TWZr3NBXqTh7Pl%2FTheme%3DLight%2C%20Size%3DRegular%2C%20State%3DOff%20-%20Disabled.svg?alt=media&#x26;token=a69118fb-5da9-4d94-8981-472f2b8b717a" alt="" data-size="line"> `Limited`

<details>

<summary>Key Access Rules</summary>

* Setting a user’s Planner Access to **Full** will automatically assign them a **paid Planner Seat** if they don’t already have one.

When Organisation-level Seats are removed, Planner Access is automatically adjusted within the User's Projects:⁠

* Users with Full Planner access will be downgraded to Limited access if their Planner seat is revoked⁠
* This ensures project access never exceeds what's permitted by organisation-level entitlements

</details>

## Managing Additional Permissions  <a href="#users" id="users"></a>

***

Project Admins can grant the Import Master Schedule permission to Members either individually or in bulk.&#x20;

* **Individual Assignment (User Panel)**
  * Locate a specific User in the table
  * Click on the User's name&#x20;
  * In the Extra Permissions section, toggle on <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FrvTcctNRDtoOHaw7U9zU%2FTheme%3DLight%2C%20Size%3DRegular%2C%20State%3DOn.svg?alt=media&#x26;token=d08029bc-cd20-4401-bc69-8ded58cdca38" alt="" data-size="line"> `Import Master Schedule`
* **Bulk Assignment (User Table)**
  * Select multiple Users using the ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FUmk4xHroFcifJzozWIty%2FGrab%20Select.svg?alt=media\&token=2d16c5b8-ca42-4e97-882e-f4bb8c21a5d8) checkboxes
  * Click the Additional Permissions icon in the multi-select toolbar.&#x20;
  * Toggle on <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FrvTcctNRDtoOHaw7U9zU%2FTheme%3DLight%2C%20Size%3DRegular%2C%20State%3DOn.svg?alt=media&#x26;token=d08029bc-cd20-4401-bc69-8ded58cdca38" alt="" data-size="line"> `Import Master Schedule` for the selected users.&#x20;

<details>

<summary>Additional Permissions Indicator</summary>

Users with Additional Permissions applied will display an icon  <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fiuqccz9mBLHOe7llYHJL%2FAtomic%20Tag%20Anatomy.svg?alt=media&#x26;token=11c7b708-d6cf-482b-8b0d-1a12dec86695" alt="" data-size="line"> next to their Project Role.

* The icon shows a n+ count of additional permissions assigned.&#x20;
* Hovering over the icon displays a tooltip listing the permissions.&#x20;

If no users have Additional Permissions, the icon column will not appear in the User Table.

</details>

## Adding Project Users <a href="#users" id="users"></a>

***

#### To add a new User into your Project:

* Open the Project and click your Project Title in the top left, then `Users`
* Click "Add User" to trigger the Project Add User window
* Enter email addresses separated by commas⁠
* The system will validate email formats and check for existing users⁠&#x20;
* Choose between `Admin` or `Member` for their Project Role
* Toggle the <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FrvTcctNRDtoOHaw7U9zU%2FTheme%3DLight%2C%20Size%3DRegular%2C%20State%3DOn.svg?alt=media&#x26;token=d08029bc-cd20-4401-bc69-8ded58cdca38" alt="" data-size="line"> `Full` or <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Frg1G65TWZr3NBXqTh7Pl%2FTheme%3DLight%2C%20Size%3DRegular%2C%20State%3DOff%20-%20Disabled.svg?alt=media&#x26;token=a69118fb-5da9-4d94-8981-472f2b8b717a" alt="" data-size="line"> `Limited`  Planner Access options as needed⁠
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F9UgHVVFzHb4NOvLKeCpS%2FFinish%20Button.svg?alt=media&#x26;token=2cc7bd61-d130-4a18-8028-8e6e2a3ac0da" alt="" data-size="line">

<details>

<summary>What is the experience for newly Invited Users?</summary>

* Users receive email invitations automatically when added⁠
* These email invitations will have a shortcut to create an account
* Once an account is created, the User will be able to access your Organisation and Project
* The invite link is optional - invited Users can also sign up directly using their invited email address at [app.aphex.co/sign-up](https://app.aphex.co/sign-up)

</details>

<details>

<summary>Adding User Rules</summary>

* Adding Users to Projects automatically adds them to the Organisation as Members⁠
* Assigning Full access may trigger seat allocation and billing⁠
* Some Organisations limit who can add Users to Projects⁠

</details>

## Archiving Project Users <a href="#users" id="users"></a>

***

Archiving a User blocks their access to the Project without deleting their data or records in the Project.

#### To Archive a User:

Open the Project and click your Project Title in the top left, then `Users`

* **Indiviual Archive:**&#x20;
  * Locate a specific User in the table
  * Hover over their row and click `...` then `Archive User`​
  * Confirm
* **Bulk Archive**:
  * Select multiple Users using the ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FUmk4xHroFcifJzozWIty%2FGrab%20Select.svg?alt=media\&token=2d16c5b8-ca42-4e97-882e-f4bb8c21a5d8) checkboxes
  * Use the multi-select toolbar <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FGl86nA6I40QWttnCAocM%2FFAB%20(1).svg?alt=media&#x26;token=2afcf1e6-a7f2-4a2e-abfd-6671c61d3b3b" alt="" data-size="line"> to choose `...` then `Archive Users`​
  * Confirm

<details>

<summary>What Happens When Project Users Are Archived</summary>

**Access Blocked**

* Users are blocked from opening the Project

**Cannot Be Allocated New Tasks**

* &#x20;Other users cannot add archived Users as Task Owners or Assignees

**Status Indication**

* Archived users show as `Archived` throughout the project

**Billing Impact**

* Archiving a Project User has no impact on their Paid Seat or billing status&#x20;

**Records Preserved**

* User data and activity history remain intact⁠ on the Project

**Super Admin Protection**

* If archiving a Project Admin, there must be at least one other active Project Admin⁠

</details>

<details>

<summary>Restoring an Archived Project User</summary>

**Automatic Reactivation**: Restores the User's access to the Project and they can plan & be assigned work as before.

</details>

## Deleting Project Users <a href="#users" id="users"></a>

***

Deleting a Project User removes all record of that User from your Project. Users must already by archived, and not own any Tasks or Packages before they can be deleted⁠.&#x20;

#### To Delete a Project User:

Open the Project and click your Project Title in the top left, then `Users`

* **Individual Delete:**&#x20;
  * Locate a specific User in the table
  * Hover over their row and click `...` then `Delete User`​
  * Confirm
* **Bulk Delete**:
  * Select multiple Users using the ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FUmk4xHroFcifJzozWIty%2FGrab%20Select.svg?alt=media\&token=2d16c5b8-ca42-4e97-882e-f4bb8c21a5d8) checkboxes
  * Use the multi-select toolbar <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FGl86nA6I40QWttnCAocM%2FFAB%20(1).svg?alt=media&#x26;token=2afcf1e6-a7f2-4a2e-abfd-6671c61d3b3b" alt="" data-size="line"> to choose `...` then `Delete Users`​
  * Confirm

<details>

<summary>What Happens When Users Are Deleted from the Project</summary>

**Permanent Removal**:&#x20;

* Deleting a User fully removes them from the Project. They can’t be restored but they can be re-invited if needed, and will need to be re-added to any Tasks.

**Data Impact**:

* Any changes the user made to a task remain in-tact and recorded as a historic event on the Task

</details>

## Task Delegates <a href="#users" id="users"></a>

***

Task Delegates allow one user to edit all tasks owned by another.\
For example, if User A is set as a Task Delegate for User B, they can edit any task assigned to User B.

A user can have multiple Task Delegates, and there’s no limit to how many can be assigned.

#### To set a Task Delegate:

* Open the Project
* Click your Project Title in the top left, then `Users`
* Locate the User you want to set a Delegate for
* Click on the User's name to open the User Panel
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FZiY4qsiylqHuQcjbAeg7%2FButton%20Design%2025-26.svg?alt=media&#x26;token=a83ed9fb-539c-4f53-922c-d34847737eb0" alt="" data-size="line"> in the Task Delegate section
* Select one or more Users who should be able to edit all Tasks owned by this User

See also: <a href="../planner/features/project-users-and-teams" class="button secondary">Task Ownership</a>

<details>

<summary>Task Delegate Permissions</summary>

Task Delegates can interact with a Task with all the same permissions as an Owner, aside from:

* Making the Task Ready

</details>

## Plan Reviewer <a href="#users" id="users"></a>

***

Plan Reviewers create a two-step approval process for weekly plan updates.\
When a Task Owner marks their work as Ready, their assigned Reviewer gets notified and should review it before the final version is published.

#### To set a Plan Reviewer:

* Open the Project
* Click your Project Title in the top left, then `Users`
* Locate the User you want to set a Reviewer for
* Click on the User's name to open the User Panel
* In the Plan Reviewer section, open the dropdown menu
* Choose one User to act as the Reviewer for that person’s plan

See also: <a href="../../planner/features/readying-and-reviewing-plans#reviewing-plans" class="button secondary">Reviewing Plans</a>

## Exporting Project Users <a href="#users" id="users"></a>

***

Exporting Project Users allows you to download a CSV file containing user data from the Project Users table.

#### **To Export Project Users:**

* Open the Project and click your Project Title in the top left, then `Users`
* Select <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fbf5KqA2IE1uG4s6SnvuF%2FDownload%20Button.svg?alt=media&#x26;token=d602583a-c1ca-48ba-9bcb-f856eeaae83e" alt="" data-size="line"> at the top right of the table

<details>

<summary>Project Users Export Format</summary>

<table><thead><tr><th width="237">Column</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>User's chosen display name</td></tr><tr><td>Email</td><td>User's email address</td></tr><tr><td>Role</td><td>User's Project Role</td></tr><tr><td>LastLogin</td><td>The date of the last time the user logged in to the Organisation</td></tr><tr><td>Planner Access</td><td>Full/Limited</td></tr><tr><td>Status</td><td>Archived/Active</td></tr><tr><td>Task Delegate</td><td>Email addresses of the User's Task Delegates</td></tr><tr><td>Plan Reviewer</td><td>Email address of the User's Plan Reviewer</td></tr></tbody></table>

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.aphex.co/docs/organisations-and-projects/projects.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
