---
alias: modules-routing-and-dispatching-reasons-tutorial-hold-reason
description: "Configure a Hold reason and follow the scenarios for holding and releasing single or multiple materials."
---

# Hold Reason

A **Hold Reason** temporarily stops a **Material** from progressing through the manufacturing process. When a **Material** is on hold, it cannot move between **Steps** or **Resources**, and the system restricts most operations.

Use **Hold Reasons** for situations such as:

- Quality investigations
- Pending inspection results
- Engineering review
- Equipment calibration issues
- Customer requests
- Regulatory compliance

!!! warning
    When a material is on hold:

    - It cannot move into or out of a Step or Resource.
    - It cannot continue normal manufacturing operations.
    - It cannot be consumed.
    - It can be released when the hold condition is resolved.
    - Its sub-materials are also placed on hold when the parent material is held.

## Configure a Hold Reason

1. Open the **Reason** module and create a new **Reason**.
1. Enter a name for the **Hold Reason**.
1. Select the **Hold** type.
1. Optionally select a category from [[reasoncategory-lt]].
1. Optionally select a security **Role**. That **Role** restricts who can release **Materials** held for this **Reason**.
1. Enable **Concurrent Instances** if the same **Reason** should be applied multiple times to the same **Material**.
1. Optionally define the distribution list and select **Create**.

    ![Hold reason configuration page](../images/reasons-tutorial-33.png)

Assign the **Hold Reason** to the `Coating` **Step**.

![Step configuration with the hold reason assigned](../images/reasons-tutorial-34.png)

## Scenario 1: Hold a Single Material

1. Open the `Coating` **Step** view and select the `Engine Block H08-P9.002` **Material**.
1. Select **Hold**.

    ![Hold action from the step view](../images/reasons-tutorial-35.png)

1. Select the **Hold Reason** and, if needed, enter a label, a comment, and a release code.
1. Confirm that the **Release Role** is filled automatically from the reason configuration, then select **Hold**.

    ![Hold wizard for a single material](../images/reasons-tutorial-36.png)

1. Confirm that the **Material** shows the hold icon in the **Step** view.

    ![Material marked as on hold in the step view](../images/reasons-tutorial-37.png)

1. Select the same **Material** and choose **Release**.

    ![Release action for the held material](../images/reasons-tutorial-38.png)

1. Try to release the **Material** without entering the release code.

    ![Release wizard without a release code](../images/reasons-tutorial-39.png)

1. Confirm that the system shows an error.

    ![Error shown when the release code is missing](../images/reasons-tutorial-40.png)

1. Go back, enter the release code used during the hold action, and release the **Material**.

You can also release the **Material** without the code if you have access to **Special Release**.

<!-- Video filename: reasons-hold-single-material.mp4 -->
{% set video_id = 'c56378b68f2ebe676667752621ef44b6' %}
{% include-markdown 'includes/cloudflare_stream.md' %}

## Scenario 2: Hold Multiple Materials

1. Go to **Quality** > **Material Holds**.

    ![Material Holds page](../images/reasons-tutorial-41.png)

1. Select **Mass Hold**.

    ![Mass Hold action](../images/reasons-tutorial-42.png)

1. Use the standard filters, or use the **Source** filter, and select **Search**.

    ![Material Holds filters before searching](../images/reasons-tutorial-43.png)

1. Select several **Materials** and choose **Next**.

    **Materials** can belong to different **Steps**, **Flows**, **Products**, or POs, but all involved **Steps** must have the same **Hold Reason** assigned.

    ![Selected materials for mass hold](../images/reasons-tutorial-44.png)

1. Select one or more reasons and, if needed, enter a label, a comment, and a release code.
1. Confirm that the **Release Role** is filled automatically, then select **Hold**.

    ![Mass hold wizard with selected reasons](../images/reasons-tutorial-45.png)

1. Confirm that the held lots appear in the grid.
1. Review the last column to see how many **Hold Reasons** are assigned to each **Material**.

    ![Mass hold results grid](../images/reasons-tutorial-46.png)

    ![Held lots listed after the operation](../images/reasons-tutorial-47.png)

1. To release the lots, select **Mass Release**.

    ![Mass Release action](../images/reasons-tutorial-48.png)

1. Filter by label, for example `vendor`, and select **Search**.

    ![Filtering held lots by label before release](../images/reasons-tutorial-49.png)

1. Select one or more lots and choose **Next**.
1. Review the selected lots and their assigned **Hold Reasons**, then select **Release**.

    ![Mass release wizard](../images/reasons-tutorial-50.png)

<!-- Video filename: reasons-hold-multiple-materials.mp4 -->
{% set video_id = '148b41f4186ccd2e0741142c9d616daa' %}
{% include-markdown 'includes/cloudflare_stream.md' %}

Next page: [Pause Reason](pause-reason.md).