Modifier Code

Modifier Codes are an optional field designed to provide additional detail to further qualify a Task Code. They are used to describe attributes such as position, function, or variation when a Task Code alone is not specific enough.

How Modifier Codes work

A Modifier Code can be assigned alongside a Task Code on a Task or Work Order.

This means:

  • The Task Code defines the component or activity
  • The Modifier Code adds context or distinction
  • Multiple Tasks can share the same Task Code while being uniquely identified by different Modifier Codes

Modifier Codes are carried through from Tasks to any Work Orders generated from those Tasks.

Common uses for Modifier Codes

Modifier Codes are commonly used to:

  • Identify physical position, such as left, right, front, or rear
  • Distinguish between primary and secondary components, such as main or pilot
  • Differentiate parallel systems or duplicated components
  • Improve accuracy in reporting and analysis

Modifier Code fields

Modifier Codes are managed using the following fields.

Field name Required Description
Code Yes Short identifier for the Modifier Code, such as LH, RH, or POS 1.
Name Yes Clear description of what the Modifier Code represents, such as Left Hand, Right Hand, or Position 1.

Creating Modifier Codes

Modifier Codes are created and managed in the configuration area of Samurai CMMS.

To create a Modifier Code:

  1. From the side menu, select Reference Tables → Task Tables → Modifier Code.
  2. Click + Add Modifier Code
  3. Enter the Code and Name. Optionally link to a System
  4. Save the Modifier Code

Where Modifier Codes apply

Modifier Codes can be applied in the following areas:

  • Tasks
  • Work Orders
  • Reporting and filtering where additional distinction is required

Example of Modifier Codes in use

A machine has two turbochargers.

Tasks may be configured as:

  • Task Code: 1052 – Turbocharger
  • Modifier Code: LEFT

and:

  • Task Code: 1052 – Turbocharger
  • Modifier Code: RIGHT

Both Tasks represent turbocharger work but are clearly distinguished. Reports can then separate left and right turbocharger maintenance while still grouping all turbocharger work together.

Reporting and analysis

Modifier Codes allow reporting to be as detailed as required.

This allows:

  • Component-level analysis with positional detail
  • Grouping by Task Code while filtering by Modifier Code
  • More accurate lifecycle and failure analysis

Important considerations

  • Modifier Codes should be used consistently across similar Assets
  • Codes should be simple and clearly understood
  • A Modifier Code cannot be deleted if it is linked to a record
  • Modifier Codes are optional and should only be used where additional clarity is needed
  • Modifier Codes do not affect maintenance scheduling, costs, or permissions

This approach provides clear, structured detail without increasing Task Code complexity.