# Downtime contextualisation

Providing reasons for machine downtimes is essential for analyzing and improving production performance. At ENLYZE, this process is called **downtime contextualisation**.

{% hint style="info" %}
What the three downtime categories (Planned, Unplanned, No Production Planned) mean and why assignment matters is explained under [Categories & assignment (Concepts)](/en/concepts/downtimes/categories-and-assignment.md).
{% endhint %}

This guide walks you through assigning reasons to detected downtimes in the ENLYZE platform.

## Prerequisites

Before you start, ensure that:

* **Downtime detection** is configured for the relevant machine :arrow\_right: [OEE](/en/production-optimization/oee.md#configuring-downtime-detection)
* **Downtime reasons** have been defined in your ENLYZE configuration :arrow\_right: [Defining downtime reasons](/en/production-optimization/downtimes/defining-reasons.md)

## Accessing the Downtime UI

Downtime contextualisation is performed through the ENLYZE App: [app.enlyze.com](https://app.enlyze.com)

You can access the contextualisation interface in two ways:

1. **Production Overview Panel.** It is located on the app's home page and shows downtimes per machine for the selected time range.

<figure><img src="/files/4UZFCCTrkjX0oNvp5UIN" alt="" width="563"><figcaption></figcaption></figure>

2. **Downtime Section.** Provides the complete list of downtimes across all machines. Use the dropdown in the upper-left corner to filter by machine.

<figure><img src="/files/74GRzFi2JdDGacAWCSQW" alt="" width="563"><figcaption></figcaption></figure>

To begin contextualising, simply click on the downtime entry you'd like to edit.

## How to Contextualise a Downtime

The contextualisation interface shows an overview of the selected downtime and the downtime editor:

<figure><img src="/files/72Zh9i030QwZ7evAfXFE" alt=""><figcaption></figcaption></figure>

### Assigning a Reason

* Browse the predefined reasons, organized by categories and groups.
* Click a reason to assign it directly to the downtime.
* Optionally, add a comment for clarification.
* Click **Save** (bottom right) to apply your changes.
* Click **Cancel** (bottom left) to discard your changes and restore the previous state

<figure><img src="/files/gGFcopwTrKuZh3kOVdSZ" alt=""><figcaption></figcaption></figure>

### Splitting a Downtime

To split a downtime into multiple parts:

1. Click the **scissors icon** below the downtime plot <img src="/files/2qMi18JpWd7CyO0xqoIb" alt="" data-size="line">
2. Define time intervals
3. Assign reasons to each segment individually.

<figure><img src="/files/V2uQku7OfAbksbmt0Y56" alt=""><figcaption></figcaption></figure>

Once a downtime is contextualised, the information becomes available in the **ENLYZE Manufacturing Data Platform**. This means it can be used by any connected service or application for reporting, analysis, or optimization.


---

# 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://docs.enlyze.com/en/production-optimization/downtimes/contextualisation.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.