# Task Properties

{% hint style="info" %}
A Task in Aphex is more than just a name and a date - this doc breaks down the core elements that make each Task functional, and who has the permission to edit them.
{% endhint %}

## Task Properties <a href="#properties" id="properties"></a>

***

Tasks properties are the details and metadata that can be assigned to Tasks.

<table><thead><tr><th width="143.5234375">Property</th><th width="377.11328125">Description</th><th width="145.87890625">Property Type<select><option value="33aYARvaqjcm" label="String" color="blue"></option><option value="0Rx0ObIdYOIk" label="Multi-Select" color="blue"></option><option value="eGCukuRQsXuU" label="Single Select" color="blue"></option><option value="BU3QRscvyrPC" label="Free text" color="blue"></option><option value="6sDmMdtDmKCv" label="PDF, DOC, PP" color="blue"></option><option value="gmctcU8T90VC" label="Numeric" color="blue"></option><option value="2ghQ1GanyeML" label="Date" color="blue"></option><option value="KnuJjpsEVSYV" label="Mark Up" color="blue"></option><option value="DOeJahpOt9Fj" label="File" color="blue"></option><option value="fzDztv0rmvZD" label="Mentions" color="blue"></option></select></th><th width="121.2109375" data-type="checkbox">Mandatory</th></tr></thead><tbody><tr><td><a href="../planner/features/tasks" class="button secondary">Activity ID</a></td><td>Unique identifier automatically assigned to every Task in the plan. Non-editable.</td><td><span data-option="33aYARvaqjcm">String</span></td><td>true</td></tr><tr><td><a href="../../planner/features/project-users-and-teams#adding-task-assignees" class="button secondary">Assignee</a></td><td>Users who can help to edit and update a Task</td><td><span data-option="0Rx0ObIdYOIk">Multi-Select</span></td><td>false</td></tr><tr><td><a href="../planner/features/blockers" class="button secondary">Blockers</a></td><td>Tick-off items that need to be completed before a task proceeds or finishes</td><td><span data-option="0Rx0ObIdYOIk">Multi-Select</span></td><td>false</td></tr><tr><td><a href="../../planner/features/how-do-i-change-the-non-working-days-of-a-task#creating-calendars" class="button secondary">Calendars</a></td><td>Working and non-working days of a Task</td><td><span data-option="eGCukuRQsXuU">Single Select</span></td><td>true</td></tr><tr><td><a href="../../planner/features/tasks#task-activity-log" class="button secondary">Comments</a></td><td>Thread of communication on the Task, with @mentions of other users.</td><td><span data-option="fzDztv0rmvZD">Mentions</span></td><td>false</td></tr><tr><td><a href="../../planner/features/tasks#task-activity-log" class="button secondary">Documents</a></td><td>Documents that can be uploaded and attached to Tasks</td><td><span data-option="DOeJahpOt9Fj">File</span></td><td>false</td></tr><tr><td><a href="../planner/features/how-do-i-change-the-non-working-days-of-a-task" class="button secondary">Duration</a></td><td>Duration in working days. Minimum duration of 1 day.</td><td><span data-option="gmctcU8T90VC">Numeric</span></td><td>true</td></tr><tr><td><a href="../../planner/features/tasks#drag-and-drop-tasks" class="button secondary">End Date</a></td><td>End date</td><td><span data-option="2ghQ1GanyeML">Date</span></td><td>true</td></tr><tr><td><a href="../planner/features/tasks" class="button secondary">External ID</a></td><td>A custom unique identifier used to connect a task to an external plan, this commonly represents an Activity ID in a master schedule</td><td><span data-option="33aYARvaqjcm">String</span></td><td>false</td></tr><tr><td><a href="../planner/features/structure" class="button secondary">Folder</a></td><td>Structure used to group and organise Tasks in the plan. Typically represents the Project WBS.</td><td><span data-option="eGCukuRQsXuU">Single Select</span></td><td>false</td></tr><tr><td><a href="../planner/features/labour-and-plant" class="button secondary">Labour</a></td><td>Human resources required to deliver the Task</td><td><span data-option="0Rx0ObIdYOIk">Multi-Select</span></td><td>false</td></tr><tr><td><a href="../planner/features/locations" class="button secondary">Location</a></td><td>Visual map of an on-site location of the Task, or description of the off-site location</td><td><span data-option="eGCukuRQsXuU">Single Select</span></td><td>false</td></tr><tr><td><a href="../planner/features/materials" class="button secondary">Materials</a></td><td>Material resources required to deliver the Task</td><td><span data-option="0Rx0ObIdYOIk">Multi-Select</span></td><td>false</td></tr><tr><td><a href="../planner/features/tasks" class="button secondary">Name</a></td><td>Name given to the Task</td><td><span data-option="33aYARvaqjcm">String</span></td><td>true</td></tr><tr><td><a href="../planner/features/tasks" class="button secondary">Notes</a></td><td>Additional notes that can be attached to Tasks</td><td><span data-option="BU3QRscvyrPC">Free text</span></td><td>false</td></tr><tr><td><a href="../planner/features/project-users-and-teams" class="button secondary">Owner</a></td><td>User responsible for the Task</td><td><span data-option="eGCukuRQsXuU">Single Select</span></td><td>true</td></tr><tr><td><a href="../planner/features/packages" class="button secondary">Package</a></td><td>Custom way of grouping related Tasks in the plan</td><td><span data-option="eGCukuRQsXuU">Single Select</span></td><td>false</td></tr><tr><td><a href="../../planner/features/tasks#creating-parent-and-subtasks" class="button secondary">Parent</a></td><td>Parent Task of a Subtask</td><td><span data-option="eGCukuRQsXuU">Single Select</span></td><td>false</td></tr><tr><td><a href="../planner/features/labour-and-plant" class="button secondary">Plant</a><br></td><td>Equipment and machinery required to deliver the Task</td><td><span data-option="0Rx0ObIdYOIk">Multi-Select</span></td><td>false</td></tr><tr><td><a href="../planner/features/relationship-links" class="button secondary">Related Tasks</a></td><td>Predecessors and Successors. Relationships can exist between Tasks in the form of Logic Links</td><td><span data-option="0Rx0ObIdYOIk">Multi-Select</span></td><td>false</td></tr><tr><td><a href="../planner/features/shift" class="button secondary">Shift</a></td><td>Used to label if work is scheduled during the Day, Afternoon, Night or All.</td><td><span data-option="eGCukuRQsXuU">Single Select</span></td><td>true</td></tr><tr><td><a href="../planner/features/tasks" class="button secondary">Start</a></td><td>Start date</td><td><span data-option="2ghQ1GanyeML">Date</span></td><td>true</td></tr><tr><td><a href="../planner/features/resources-and-assets" class="button secondary">Subcontractor</a></td><td>Subcontractor responsible for delivering the Task</td><td><span data-option="eGCukuRQsXuU">Single Select</span></td><td>false</td></tr><tr><td><a href="../planner/features/how-do-i-promise-tasks" class="button secondary">Status</a></td><td>The overall state of a Task</td><td><span data-option="eGCukuRQsXuU">Single Select</span></td><td>true</td></tr><tr><td><a href="../planner/features/tags" class="button secondary">Tag</a></td><td>Custom labels used to group, filter, or track tasks across your Project</td><td><span data-option="0Rx0ObIdYOIk">Multi-Select</span></td><td>false</td></tr><tr><td><a href="../planner/features/milestones" class="button secondary">Target Date</a></td><td>Milestone Target Date</td><td><span data-option="2ghQ1GanyeML">Date</span></td><td>false</td></tr><tr><td><a href="../planner/features/clashes-and-work-area" class="button secondary">Work Area</a></td><td>Physical location of a Task on-site, marked-up on a Map</td><td><span data-option="KnuJjpsEVSYV">Mark Up</span></td><td>false</td></tr></tbody></table>

## Task Permissions <a href="#permissions" id="permissions"></a>

***

<table><thead><tr><th> Permission</th><th width="146.30859375" data-type="checkbox">Owner / Admin</th><th width="105.73046875" data-type="checkbox">Assignee</th><th width="139.18359375" data-type="checkbox">No Task Role</th></tr></thead><tbody><tr><td>Delete Task</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Duplicate Task</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Add Subtasks</td><td>true</td><td>false</td><td>false</td></tr><tr><td>Update Task Links</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Update Task Dates, Duration, Calendar and Shift</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Update Task Blockers</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Update Task Tags</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Update Task Subcontractor, Labour, Plant and Materials</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Update Task Location and Work Area</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Update Task Parent</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Update Package</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Update Folder</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Update External ID</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Mark as Non-Conflicting</td><td>true</td><td>false</td><td>false</td></tr><tr><td>Convert to Milestone </td><td>true</td><td>true</td><td>false</td></tr><tr><td>Update Target Date</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Update Task Owner</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Update Task Assignees</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Add Task Comment</td><td>true</td><td>true</td><td>true</td></tr><tr><td>Update Task Notes</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Update Task Documents</td><td>true</td><td>true</td><td>true</td></tr><tr><td>Update Task Status</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Update Material Actuals</td><td>true</td><td>true</td><td>false</td></tr><tr><td>Record Progress Update</td><td>true</td><td>true</td><td>false</td></tr></tbody></table>


---

# 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/account-and-task-properties/task-properties.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.
