> For the complete documentation index, see [llms.txt](https://help.aphex.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aphex.co/docs/planner/features/production-measures.md).

# Production Measures

Production Measures let you define the measurable outputs work is planned against, each created with a name, unit (e.g. ‘Panels, each’), and an optional target rate per day. When a target rate is set, Aphex calculates the implied daily rate and compares it against that target, surfacing the variance as a red, amber, or green indicator in a dedicated Production Measure column on the Gantt.

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FEr3kUYJprT26JZ4jANAJ%2FAlign%20Task%20Duration.png?alt=media&amp;token=37f12655-1f19-4811-90ce-4f0b081a149f" alt=""><figcaption></figcaption></figure>

## Creating Production Resources&#x20;

***

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F81V2LGZitloSzQ3B3xjS%2FCreate%20Production%20Measure.jpg?alt=media&amp;token=3110ac6d-ddae-4c87-98d5-6112c764d83d" alt=""><figcaption></figcaption></figure>

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

#### To create Production:

* Click your Project Title in the top left, then select  `Project Assets`&#x20;
* Select `Production` from the menu
* Click <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F5EoniKtjMS9WwkzPW0rx%2FButton%20(7).png?alt=media&amp;token=249d3ab7-06e6-4c3b-bbb8-07e6b6604d09" alt="" data-size="line">
* Create your custom Production resource by entering the `Name`, `Unit` and a `Colour`
* Optionally assign a  `Unit Name` and toggle <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FXiM0p3ebZCtD7r7MrKBO%2FControl%20(1).png?alt=media&amp;token=c7ce6e0c-1172-4e01-b8d9-f7848c9d3402" alt="" data-size="line"> Set Daily Target Rate
* The Production resource is added to the library of Production the team can assign to their Tasks

<details>

<summary>Production Measure Resource rules</summary>

* The Unit is confirmed once a measure is created; name, colour and target rate can be edited. Percentage-based measures have no quantity, target or breakdown.
* Choosing Count adds a custom Unit Name e.g. ‘Panels’.

</details>

## Assigning Production to tasks

***

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FUsckZKZYMphIlYzKKxi9%2FChange%20production%20measure.svg?alt=media&amp;token=3417a519-f7cd-4031-8a05-6ca8247d18c0" alt=""><figcaption></figcaption></figure>

#### **To assign the Production Measure to a Task:**

* From Gantt view, click ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FvKmhsEo7KN1cBILxsani%2FColumn%20Picker%20Buttons.svg?alt=media\&token=9c6cc79d-7f88-4492-a6ea-7f2ba6418ffc)<kbd>Column</kbd>
* Toggle ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fi95XyOgpy7hzTLYWhvru%2FControl.svg?alt=media\&token=b4440363-6bc5-4836-8d65-19a701f9a308) on <kbd>Production</kbd>&#x20;
* Click on the Task's <kbd>Production</kbd> cell&#x20;
* Select the <kbd>Production Measure</kbd> from the dropdown
* Set the total quantity, review the daily breakdown and alignment, then <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Fjhk0xUxsrXimTv1vYEcJ%2FText%20Buttons%20for%20Dev.svg?alt=media&amp;token=9ed1d97e-4ca1-4b84-8520-c78b60d17919" alt="" data-size="line">

#### **To change the Task's Production Measure:**

You can change or remove a task’s measure at any time by selecting a new Production Measure from the dropdown. Logged updates are never deleted. Each update stays as it was recorded, and the running total is recalculated against the task’s new measure.

<details>

<summary>Production on Tasks rules</summary>

* Only one Production Measure can be assigned to a task at a time.
* Tasks without a Production Measure show `None`. When the project is set to `Track % Complete`, the `None` option in the dropdown also shows `% Complete by Default`. This is a project default, not a measure, so it doesn’t appear in your Production library.

</details>

<details>

<summary>What happens to progress when the measure changes</summary>

<table><thead><tr><th width="381.5625">Change</th><th>Running total</th><th>Past updates</th></tr></thead><tbody><tr><td>% → % (including the <code>% Complete by Default</code>)</td><td>Carries over (40% stays 40%)</td><td>Unchanged</td></tr><tr><td>Units → %</td><td>Converts (50 of 100 panels becomes 50%)</td><td>Stay visible</td></tr><tr><td>% → Units</td><td>Resets to 0</td><td>Stay visible, but don’t count towards the unit total</td></tr><tr><td>One unit → another unit</td><td>Resets to 0</td><td>Stay visible, but don’t count towards the new total</td></tr><tr><td>Measure removed on a <code>Track End Date</code> project</td><td>No % is tracked</td><td>Stay visible</td></tr></tbody></table>

Tasks without a measure track % complete by default. See <a href="/docs/planner/features/status.md" class="button secondary">Progress</a>.

If a day shows 50% logged but the task shows 0% overall, the task was most likely switched to a unit-based measure after that update. Log units against the new measure and the total will start moving.

</details>

## Editing Planned Production

***

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FL8OlqlX2gomo8fYMfVtK%2FPlanned%20Production%20Editing.jpg?alt=media&amp;token=15f4aef6-2f8b-4cd8-82f7-db24eeee2733" alt=""><figcaption></figcaption></figure>

Make changes to the production breakdown where needed and impact the cumulative total needed.

* Right-click a Task and select `View Details`
* Scroll to `Planned Resources` and click into <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FTxyTFnsiN60qrjseKvsb%2FFields.png?alt=media&amp;token=ee1ee892-58b4-416c-a7aa-9f514bd77b46" alt="" data-size="line">&#x20;
* Update the value and see the cumulative total impact

<details>

<summary>Production Impact rules</summary>

* Unit-based measures (m³, linear metres, items, etc.) take a total quantity, support an optional daily target rate, and show a day-by-day breakdown with on![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F7AUy7m7GtKNnQBcAdALr%2FProduction%20Rates%20Variance.svg?alt=media\&token=a8e733ac-90d0-4ef6-8d0c-9dcd7b5e21b5)/ over![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FBNjqiJb8gwMhdS8DgyNH%2FAtomic%20Tag%20Anatomy.svg?alt=media\&token=347c5eb2-a7c1-4f9b-bc62-5a53dc9a86d2)/ under target<img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F0eNE4bDxgOF6Ba8YVfDS%2FProduction%20Rates%20Variance%20(1).svg?alt=media&amp;token=e977ce80-48a7-427f-899a-b8c79e001d54" alt="" data-size="line">status.

</details>

## Align your Task Duration with the Target Rate

***

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FNufopizTYgiSGQm36zCo%2FAlign%20your%20Task%20Duration%20with%20the%20Target%20Rate.jpg?alt=media&amp;token=ff53abc5-e7e5-475a-9fbe-19c0c6fdc8cf" alt=""><figcaption></figcaption></figure>

When a task's average production rate is below or in excess of its target, you can extend or shorten the task duration in one click so it lines up with the target rate  no manual recalculating needed.

* Hover the Target Rate Variance icon on the `Production` Gantt cell, in the Task side panel, or on a Board/List task card
* Where the average is off target, an `Align Task Duration` button appears
* Click it to extend or shorten the task duration until the daily average production matches the target rate
* The quantity breakdown updates automatically to reflect the new duration

## Understanding Planned Production

***

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2Ft3iIn3qxcZHrgCVb65od%2FUnderstanding%20Planned%20Production.jpg?alt=media&amp;token=10b0f2ba-92a1-4366-9685-64dc1d94f9cd" alt=""><figcaption></figcaption></figure>

Once a Production Measure with a target rate is assigned to a task, Aphex continuously compares the task's planned daily rate against that target so misalignment is visible before it becomes a problem.

#### Understanding Task movement on Planned Production

Resizing or dragging a task with a Production Measure assigned updates its plan in real time.

* As you stretch or shrink the Task Bar, a Task Resize Indicator tooltip shows a live preview of the new average daily production rate
* If the measure has a target rate set, the tooltip also shows whether that new average is aligned, above, or below target
* Release the bar to confirm the new duration the daily breakdown recalculates automatically

#### Target Rate Variance Summary

* On the Gantt, navigate to <img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FnPXDV4mSOqWZdbL2FUJ1%2FColumn%20button.png?alt=media&amp;token=ef19a57d-e322-486f-a43a-134aff7fedf0" alt="" data-size="line"> and 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&amp;token=d08029bc-cd20-4401-bc69-8ded58cdca38" alt="" data-size="line"> `Production`
* Check the visuals of ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FBNjqiJb8gwMhdS8DgyNH%2FAtomic%20Tag%20Anatomy.svg?alt=media\&token=347c5eb2-a7c1-4f9b-bc62-5a53dc9a86d2), ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F0eNE4bDxgOF6Ba8YVfDS%2FProduction%20Rates%20Variance%20\(1\).svg?alt=media\&token=e977ce80-48a7-427f-899a-b8c79e001d54)and ![](https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F7AUy7m7GtKNnQBcAdALr%2FProduction%20Rates%20Variance.svg?alt=media\&token=a8e733ac-90d0-4ef6-8d0c-9dcd7b5e21b5)to check the Target Rate Variance

<details>

<summary>Target Rate Variance meaning</summary>

<table><thead><tr><th width="81.06640625">Icon</th><th>Meaning</th></tr></thead><tbody><tr><td><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FBNjqiJb8gwMhdS8DgyNH%2FAtomic%20Tag%20Anatomy.svg?alt=media&amp;token=347c5eb2-a7c1-4f9b-bc62-5a53dc9a86d2" alt=""></td><td>Over the current target rate and could mean reforecasting is needed</td></tr><tr><td><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F7AUy7m7GtKNnQBcAdALr%2FProduction%20Rates%20Variance.svg?alt=media&amp;token=a8e733ac-90d0-4ef6-8d0c-9dcd7b5e21b5" alt=""></td><td>On the current Target and is in accordance with the daily forecast rate</td></tr><tr><td><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2F0eNE4bDxgOF6Ba8YVfDS%2FProduction%20Rates%20Variance%20(1).svg?alt=media&amp;token=e977ce80-48a7-427f-899a-b8c79e001d54" alt=""></td><td>Under the current target and could mean the duration of the task can be shortened</td></tr></tbody></table>

</details>

## Filter by Production

***

<figure><img src="https://2273109354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLu0mYklsCTm7XQm3ZGqv%2Fuploads%2FkFDw7bzW1JaNSHpzONtw%2FFilters.jpg?alt=media&amp;token=deb3d237-0ee6-416f-935f-409622f52d69" alt=""><figcaption></figcaption></figure>

#### To filter by Production:

* 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&amp;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&amp;token=fce29edb-8b74-4d75-bfa0-d8ad7292c94b" alt="" data-size="line">
* Select `Production` in the first dropdown
* Select from `Is`, `Is Not`, `Is Empty` or `Is Not Empty` in the second dropdown
* Select your desired Production measure in the third dropdown

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

<details>

<summary>Filter Breakdown</summary>

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

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.aphex.co/docs/planner/features/production-measures.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
