# Materials

{% hint style="info" %}
**Who can use this feature**&#x20;

Admins can create and manage Materials&#x20;

***

All project users can add Materials to their Tasks and log actuals&#x20;
{% endhint %}

Materials can be added to Tasks to forecast your daily resource demand and track planned vs actual quantities.

## Creating Materials

***

Creating Materials lets you build a reusable library of Materials to assign to Tasks.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F4OTzASb3pZTxSc3WPrNE%2FCreate%20Material.svg?alt=media&#x26;token=c20196c1-724f-48b3-aa72-d5cb36639d47" alt=""><figcaption></figcaption></figure>

**Creating New Materials:**

* Click your Project Title in the top left, then select  `Project Assets`&#x20;
* Select `Materials` from the menu
* &#x20;click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FjiyuWLAip5lvCBdzHSjI%2FButton%20(1).svg?alt=media&#x26;token=fef806cf-da8a-4cb5-98df-28a3d739e5f0" alt="" data-size="line">
* Create your custom Material resource by entering the name, unit, Material type and colour
* The Material is added to the library of Materials the team can assign to their Tasks

<details>

<summary>Material Type </summary>

Each material needs a Material Type from one of the following categories:

| Material Type |
| ------------- |
| Concreate     |
| Piles         |
| Earthworks    |
| Roadworks     |
| Electrical    |
| Drainage      |
| Steel         |
| Other         |

</details>

<details>

<summary>Material Unit</summary>

Each material needs a Material Unit from one of the following categories:

| Material Unit  |
| -------------- |
| Item           |
| Metres         |
| Metres Squared |
| Metres Cubic   |
| Kilometers     |
| Kilograms      |
| Tonnes         |
| Tons           |
| Yards          |
| Yards Squared  |
| Yards Cubic    |

</details>

## Assigning Materials&#x20;

***

Assigning Materials to tasks helps plan how much is needed for each one, making it easier to manage demand across your project.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FFcWkqOtUuyfII0LemJyH%2FGantt-%20Material%20(1).svg?alt=media&#x26;token=8197ab9d-ba13-4641-b091-26f2f54cc423" alt=""><figcaption></figcaption></figure>

**To add Planned Materials to a task:**

* On the Gantt, navigate to the column picker <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FfcDCzafJHCtgSfMJuQOz%2FIcon%20Buttons%20(1).svg?alt=media&#x26;token=08227bc3-6692-4d7e-818b-295f7a9cf16f" alt="" data-size="line"> and toggle <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"> `Materials`
* Click the Material cell for your task & select Materials from the dropdown menu

See also: <a href="../tasks#editing-tasks" class="button secondary">Bulk Edits</a>

<details>

<summary>Material Property Rules </summary>

* Materials are a multi-select property
* A Quantity of the Material can be inputted when adding Materials to tasks
* Quantities are applied per day
  * The unit quantity is split across the task's duration
* Archived Material resources will no longer be available to add to tasks but will still exist on tasks it was assigned to before the resource was archived

</details>

## Editing Planned Daily Quantities&#x20;

***

When you add a planned Material, Aphex spreads the total amount across the Task’s planned days. If you expect to use more or less of a material on a certain day, you can adjust the daily quantity to match.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FO2VhbbHDfRr1WObZuaIG%2FMaterials%20-%20Planned.svg?alt=media&#x26;token=69303eca-3984-49c6-91f6-027667ddeea1" alt=""><figcaption></figcaption></figure>

#### To adjust the daily planned quantities:

* Double-click your task bar on the Gantt to open the right-hand panel
* Scroll down to `Planned Resources` and click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F2ww29X4huVUxXaygDvFh%2FIcon%20Buttons%201.svg?alt=media&#x26;token=a30a6b6b-7849-488c-9b54-28be4252dd3c" alt="" data-size="line"> to expand your chosen Material
* Click into the Quantity box and change the value&#x20;

## Material Actuals&#x20;

***

Material tracking doesn't just stop at forecasting demand. Use Actuals to log what was used each day, directly on the Task - giving you a clear picture of performance over time, and use the inputs to automatically generate planned vs actual quantity reports.&#x20;

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FT6rofUDFnt5pZ4E65aZG%2FMaterials%20-%20Actuals.svg?alt=media&#x26;token=bcc6c0f2-ff77-4a9c-8a67-cb7bbd06df73" alt=""><figcaption></figcaption></figure>

**Adding Actuals to Tasks:**

* Double-click your task bar on the Gantt to open the right-hand panel
* Scroll down to `Actual Materials` and click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F2ww29X4huVUxXaygDvFh%2FIcon%20Buttons%201.svg?alt=media&#x26;token=a30a6b6b-7849-488c-9b54-28be4252dd3c" alt="" data-size="line"> to expand your chosen Material
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FsM2paq0YxhwqYWdshWUR%2FText%20Buttons%20(6)%201.svg?alt=media&#x26;token=68fe97cb-b889-4f20-840e-199893fa935a" alt="" data-size="line">and select a planned material&#x20;
* Pick a day to record the Actual against, enter the Quantity and click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FmR6cEQh6zVAxbVqavdKl%2FIcon%20Buttons%20(1).svg?alt=media&#x26;token=b206e05d-2a34-4e9b-ad0a-6cdd773d99da" alt="" data-size="original"> to confirm

## View Forecasted Materials on the Gantt

***

Use the Resource Overlay in the Gantt to forecast Material demand day by day. You'll see how much of each Material is needed across the project, with a clear breakdown of which Tasks are driving that usage and who's using it.&#x20;

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F5QMkT6jJ5WTuJxkHVtvy%2FResource%20overlay%20-%20Material%20(4).svg?alt=media&#x26;token=67479d0a-343b-41bb-a75a-aab932821824" alt=""><figcaption></figcaption></figure>

**View the Resource Overlay by Material:**

* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fght2Ug6Fnh80JV9rDzKs%2FSub%20Nav%20Buttons.svg?alt=media&#x26;token=680e7e22-ba8e-4a33-9280-3e0206fa97f0" alt="" data-size="line"> and select `Resources` and click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FOQWEkH3hyd6p1iibQvgr%2FMaterials.svg?alt=media&#x26;token=93ee3761-56b0-4188-b864-288c43624401" alt="" data-size="line"> Material
* Hover over the numbers to view your `Total` and `Project Utilisation`
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FPt43XTI2R7SxDRvYVF1y%2FText%20Buttons%20-%20Work%20In%20Progress.svg?alt=media&#x26;token=5daae77a-8784-4d3b-85a6-36b5af6ccb6d" alt="" data-size="line"> to filter to a specific Material type
* Click the Resources Configuration icon <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F7FmfgbVCzFvy29v6OYGm%2FIcon%20Buttons%20from%20Figma.svg?alt=media&#x26;token=d94cee5c-fed3-4842-aff9-b56b298b1ef8" alt="" data-size="line"> to switch between `Tasks in View` and `Project Utilisation`
* Hover over <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F9D1l2IvdqWBj57q8lUGG%2F01%20Normal.svg?alt=media&#x26;token=00daf3e1-b03f-4b53-a171-cb2233e9c9ab" alt="" data-size="line"> to see the daily breakdown

See also: <a href="../imports-and-exports#exporting-resources" class="button secondary">Export Material Demand</a>

<details>

<summary>What's Shown on Hover</summary>

On hover, the daily breakdown includes:

* **Utilisation**
  * Quantity of Material used by Tasks in your current View (respects filters)
* &#x20;**# of Tasks**
  * Number of Tasks in your current View using that Material on the selected day (respects filters)
* **Project** **Utilisation**
  * Total quantity used across the entire project (ignores filters)
* **# no of Project Tasks**
  * Number of Project-wide Tasks using that material on the selected day (ignores filters)
* **Task Owner Breakdown**
  * Lists each Task Owner contributing to Project usage&#x20;
  * Includes Task Count and percentage of total utilisation for that day and Material&#x20;
* **Cell shading**
  * **Darker = higher quantity**
  * Lighter - lower quantity
  * Scale is relative to the values shown in the current overlay
* **Quantity values** are only shown in Day View
  * In Week, Month or Year mode, cell shading remains but numeric values are hidden

</details>

<details>

<summary>Resource Overlay Configuration Options </summary>

| Option                         | Function                                                                   |
| ------------------------------ | -------------------------------------------------------------------------- |
| **Total**                      | The demand for tasks in your current view                                  |
| **Project Utilisation**        | The demand for your entire project                                         |
| **Hide Un-utilised resources** | Removes resources that aren’t assigned to any Tasks from the resource list |

</details>

## Filter by Material&#x20;

***

Filter by Material to quickly review and manage work related to a particular Material items across your plan.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FUrZOgDkPYDg8eLA91Z79%2FFilted%20by%20Material%201%20(3).svg?alt=media&#x26;token=5abeea80-2de8-4de2-baf3-85590df27285" alt=""><figcaption></figcaption></figure>

#### Filter by Material:

* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F1uSzhSb5aSNnZd5vTaGB%2FFilter%20Button.svg?alt=media&#x26;token=8ddd7f1c-0296-4af2-bdeb-d08d56fc56b6" alt="" data-size="line"> and <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FbVv9qtyepRHQfkVwypud%2FText%20Buttons%20(2).svg?alt=media&#x26;token=fce29edb-8b74-4d75-bfa0-d8ad7292c94b" alt="" data-size="line">
* Select `Material` in the first dropdown
* Select from `Is`, `Is Not`, `Is Empty` or `Is Not Empty` in the second dropdown
* Select your desired Material item in the third dropdown

See also: create & share <a href="view-controls" class="button secondary">Views</a>

<details>

<summary>Filter Breakdown</summary>

| Filter   | Operator                                           | Value                          |
| -------- | -------------------------------------------------- | ------------------------------ |
| Material | <p>Is <br>Is Not <br>Is Empty <br>Is Not Empty</p> | <p>Multi-Select</p><p><br></p> |

</details>

## Report on Planned vs Actual Material

***

Once Materials have been assigned to Tasks, all updates (including Delays, On Track & Improvement events) can be traced back to each Subcontractor. This makes it easy to understand how each Subcontractor is performing across the project.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FoBceT6OhZoH3Mv3MhFtI%2FMaterial%20-%20Insight.svg?alt=media&#x26;token=6daafb0b-0489-42fa-bff7-41d3804db4c7" alt=""><figcaption></figcaption></figure>

#### Power BI

Connect your Project as a datasource for Power BI to report on Material Demand, and track Planned vs Actuals.

#### Aphex Insight&#x20;

Utilise Aphex Insight to track Material Demand. See trends and drill down into specific Tasks to identify where each Material Resource is allocated.

See also: <a href="../../integrations-and-api/power-bi/getting-started-with-power-bi-reporting" class="button secondary">Connect to Power BI</a>


---

# 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/planner/features/materials.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.
