Skip to main content

Getting Started with OEE Configuration

This guide walks you through setting up OEE tracking for your first equipment line. By the end, your operators will be able to log downtime with structured reasons, and supervisors will see OEE breakdowns by loss type.

Prerequisites​

Before you begin, make sure you have:

  • At least one equipment item created in OpSee
  • Admin or OEE configuration permissions

Step 1: Create Loss Categories​

Loss categories are optional business-level groupings. They help with reporting but are not required for basic OEE tracking.

Navigate to Admin → OEE → Loss Categories and create categories that match your plant's organization:

Example CategoryDescription
MechanicalAll mechanical failures and wear
ElectricalElectrical faults, sensor issues
ProcessProcess-related stops (recipe changes, quality holds)
ExternalCauses outside production control

Loss categories list

:::info Optional step If you just want to get started quickly, you can skip loss categories and come back to them later. Loss types work independently. :::

Step 2: Create Loss Types​

Loss types map directly to OEE theory. Navigate to Admin → OEE → Loss Types and create types for each relevant OEE category.

A good starting set:

Loss Type NameOEE CategoryWhat it covers
Equipment FailureUnplannedBreakdowns, jams, tool failures
Setup & ChangeoverPlannedRecipe changes, material changes
Planned MaintenancePlannedScheduled maintenance windows
Minor StopsPerformanceShort interruptions < 5 min
Reduced SpeedPerformanceRunning below ideal cycle time
Startup RejectsQualityDefects during warmup
Production RejectsQualityDefects during stable production

Create loss type form

For each loss type, select the appropriate OEE category. This determines how the loss affects the OEE calculation (Availability, Performance, or Quality).

:::tip Match the Six Big Losses The loss types above map directly to the Six Big Losses. This alignment ensures your OEE calculations follow industry standards. :::

Step 3: Create Reasons​

Reasons are the specific causes your operators will choose when logging downtime. Navigate to Admin → OEE → Reasons.

Create reasons that are specific enough to be actionable but general enough to be used consistently:

Good ReasonsToo VagueToo Specific
Belt brokenMachine problemBelt #3 on conveyor C-12 torn at splice point
Material shortageWaitingWaiting for PO #12345 batch of polymer A
Operator breakBreakJohn went to lunch at 12:15

Reasons list

:::tip Aim for 15–30 reasons Studies show that 15–30 well-chosen reasons cover 90%+ of downtime events in most plants. Start with fewer and add more as operators request them. :::

Step 4: Build a Reason Tree​

This is where everything comes together. Navigate to Admin → OEE → Reason Trees.

Create the Tree​

Click + Create and give your tree a descriptive name (e.g., "Packaging Line Reasons" or "General Production").

Add nodes​

Build a hierarchy that guides operators from broad categories to specific reasons:

📁 Mechanical Failure (Loss Type: Unplanned)
├── Belt broken
├── Bearing failure
└── Motor overload
📁 Electrical (Loss Type: Unplanned)
├── Sensor fault
└── PLC error
📁 Changeover (Loss Type: Planned)
├── Recipe change
└── Material change
📁 Operator (Loss Type: Planned)
├── Break
└── Training
📁 Quality Issue (Loss Type: Quality)
├── Out of spec
└── Contamination

For each node:

  1. Select a Reason from the dropdown
  2. Assign a Loss Type (or let it inherit from the parent node)
  3. Optionally set a Color for visual distinction in dashboards

Reason tree visualizer

:::tip Use inheritance Assign the loss type at the top-level nodes (e.g., "Mechanical Failure" → Unplanned). All child reasons inherit this classification automatically. Only override at the leaf level when a specific reason needs a different loss type. :::

Step 5: Assign to Equipment​

The final step connects your reason tree to your equipment. Navigate to Admin → Equipment and open an equipment item's OEE settings.

Select the reason tree that applies to this equipment. Different equipment types can use different trees — a packaging line might have different failure modes than a mixing tank.

Equipment OEE settings

Verify your setup​

Once configured, test the setup:

  1. Open the Production → OEE → Downtime view
  2. Find a downtime event for your equipment
  3. Click on the event to open the reason selection
  4. Verify that you can navigate the reason tree and select a reason
  5. Check that the OEE dashboard shows the correct loss type breakdown

Next steps​

  • Loss Categories — Deep dive into category management
  • Loss Types — Advanced loss type configuration
  • Reasons — Managing your reason library
  • Reason Trees — Advanced tree features (duplication, color coding, equipment type filtering)
  • Analytics — View your OEE data once it starts flowing