Skip to main content

Maintenance App

The Maintenance App keeps your preventative maintenance organized, on schedule, and fully documented. Instead of manually tracking when each piece of equipment needs service, the platform automatically monitors usage and calendar intervals, alerts you when maintenance is approaching, and keeps a complete historical record of everything that has been completed.


๐Ÿ”„ How Maintenance Status Worksโ€‹

Every maintenance job follows a defined lifecycle. Understanding these statuses tells you exactly what action is needed at each stage.

StatusMeaningAction Required
๐Ÿ”ต UpcomingApproaching the due threshold โ€” advance warning so you can preparePlan ahead, order parts if needed
๐ŸŸก DueThe maintenance interval has been reached โ€” service is required nowSchedule and complete promptly
๐ŸŸข ScheduledA service date and assigned technician have been confirmedEnsure the job is completed on the scheduled date
๐Ÿ”„ In ProgressThe job is actively being worked onMonitor to completion
โœ… CompletedThe maintenance has been documented and closedVisible in History
๐Ÿ”ด MissedThe maintenance was not completed before the next occurrence became dueInvestigate and complete as soon as possible

โš ๏ธ Non-obvious: If a scheduled job is not completed within three days of the scheduled date, it automatically reverts to Due status. Complete scheduled jobs promptly to keep your workflow moving forward.


๐Ÿ–ฅ๏ธ The Dashboardโ€‹

The Dashboard is your command center โ€” it surfaces everything that needs attention right now.

Summary Chartsโ€‹

Maintenance Status Chart โ€” A donut chart showing the current distribution of all maintenance jobs across Upcoming, Due, Scheduled, In Progress, and Completed statuses. Hover over any segment to see the exact count and percentage.

Maintenance Status Trend โ€” A line chart showing Upcoming and Due maintenance activity over the last 7 days. Hover over any point to see the exact count for that date. Use this chart to identify patterns โ€” such as recurring spikes on specific days or weeks โ€” and plan staffing accordingly.

Maintenance Reminders Listโ€‹

Below the charts, the Maintenance Reminders List shows every asset with an active maintenance job. This is where day-to-day work happens.

What does each column mean?
ColumnDescription
AssetThe equipment requiring maintenance
Serial NumberAsset serial number
Maintenance PlanThe plan governing this maintenance interval
StatusCurrent status โ€” Upcoming, Due, Scheduled, or In Progress
Assigned ToThe technician or team assigned to this job
ActionSchedule Job, Complete Job, or add an off-cycle repair

Available tools: Search by asset name, plan name, or status ยท Filter by Upcoming or Due ยท Export to CSV


๐Ÿ“… Scheduling a Maintenance Jobโ€‹

When a job is Due or Upcoming and you're ready to plan the service, click the Schedule Job icon on that maintenance row. A dialog opens where you confirm and assign the work.

  1. Check for planning tasks โ€” If the maintenance plan requires prep work before scheduling, a Complete Maintenance button appears. Complete any required pre-service tasks before proceeding.
  2. Review required parts โ€” The dialog shows which parts are needed for this job. If parts are not on hand, click Purchase Kit to order them directly from the scheduling dialog.
  3. Set the schedule date โ€” Enter the date the work is planned to occur.
  4. Add notes โ€” Record any relevant context for the assigned technician.
  5. Assign a technician โ€” Select the user responsible for completing the job.
  6. Submit โ€” The maintenance status changes to Scheduled and the assigned technician's name is recorded.

๐Ÿ’ก If you are missing parts, use Purchase Kit at the time of scheduling so they arrive before the service date โ€” not after.


โœ… Completing a Maintenance Jobโ€‹

When a job has been performed, click the Complete Job icon on the maintenance row to document and close it.

If a checklist is attached to this maintenance plan, you must complete it before the form can be submitted:

  1. Click Complete Task in the dialog
  2. Work through all checklist items
  3. Return to the completion form โ€” the Submit button is now enabled

Then document the completed work:

What does each field mean?
FieldDescription
Work Order Documents / PhotosUpload supporting files โ€” work orders, photos, inspection records
Job NumberWork order or reference number
Date of ServiceWhen the maintenance was performed
Run Hours / ParametersAsset meter reading or key operational parameter at time of service
Technician NotesWhat was done, any issues found, recommendations
Completed ByThe technician who performed the work

Submit the form and the job is marked Completed. It moves to Maintenance History and is no longer shown in the active reminders list.


โž• Adding an Off-Cycle or Repair Jobโ€‹

Not all maintenance follows a planned schedule. For unscheduled repairs or one-off service needs, click the โž• Add button on the Dashboard to create an off-cycle maintenance record. This captures the work in the system and preserves the historical record even when the work was not part of a pre-existing plan.


๐Ÿ“œ Maintenance Historyโ€‹

Click History in the sidebar to view all completed and missed maintenance records.

History Chart โ€” Displays maintenance activity over your selected date range. Filter by annual view or set a custom From / To date range to narrow the period.

History Table โ€” Lists all historical maintenance records.

What does each column mean?
ColumnDescription
Service DateWhen the work was completed
StatusCompleted or Missed
AssetEquipment that was serviced
Serial NumberAsset serial number
Maintenance PlanThe plan this job was part of
Assigned ToTechnician who completed the work
TypeCalendar-based or Meter-based
NotesSummary notes from the completion record

Click View Details on any record to open the full documentation: who completed the work, when, run hours at service time, technician notes, attached documents, and any completed task checklists.

Available tools: Search by asset name, plan name, or status ยท Date range filter ยท Export to CSV


๐Ÿ“‹ Maintenance Plansโ€‹

Maintenance Plans are the schedules that define when and how maintenance should occur for each asset. Click Plan in the sidebar to view and manage all plans.

Each plan in the list shows its name, description, and tags. Plans can be searched and filtered by tag or type.

Creating a Maintenance Planโ€‹

Click โž• to create a new plan. Setup involves four main decisions.

1. Basic Informationโ€‹

What does each field mean?
FieldDescription
Plan NameA clear, descriptive name for the maintenance schedule
DescriptionWhat this plan covers and why
TagsLabels for organizing and filtering plans (e.g., by equipment type, location, or maintenance category)
NotificationsUsers and email addresses to notify when maintenance is triggered. Type @ to select platform users, or enter any external email address. SMS notification is also available.

2. Schedule Typeโ€‹

Choose how the maintenance interval resets after each completed job.

TypeHow It WorksExample
FixedMaintenance occurs at set intervals regardless of when the last job was completed. The schedule stays anchored to consistent milestones.Due every 100 hours. Completed at 205 hours. Next due at 300 hours.
OffsetMaintenance interval is calculated from when the last job was actually completed. The schedule adjusts based on real service timing.Due every 100 hours. Completed at 205 hours. Next due at 305 hours.

3. Schedule Rulesโ€‹

Choose the type of trigger for this maintenance plan โ€” Meter-Based or Calendar-Based. A single plan can include both.

Meter-Based Rulesโ€‹

Maintenance is triggered based on live sensor readings from the asset โ€” such as run hours, pressure cycles, or mileage.

What does each field mean?
FieldDescription
Sensor GroupThe sensor group on the selected assets to monitor
SensorThe specific sensor whose value drives this rule
Upcoming InThe sensor value threshold at which the job status changes to Upcoming
Due EveryThe sensor value interval at which the job becomes Due
Rule TypeReal-Time โ€” maintenance is triggered the moment a live reading matches the rule condition. Scheduled โ€” maintenance status is calculated periodically against the latest sensor data.

How Meter-Based Thresholds Work โ€” Example using Upcoming In = 10 and Due Every = 20:

CycleUpcoming Status Triggered WhenDue Status Triggered When
1stSensor value โ‰ฅ 10 and < 20Sensor value โ‰ฅ 20 and < 30
2ndSensor value โ‰ฅ 30 and < 40Sensor value โ‰ฅ 40 and < 50
3rdSensor value โ‰ฅ 50 and < 60Sensor value โ‰ฅ 60 and < 70

Each cycle generates one maintenance record. Completing it before the next cycle prevents a Missed status.

Calendar-Based Rulesโ€‹

Maintenance is triggered based on elapsed time since the asset's creation date (Fixed) or last completed service (Offset).

What does each field mean?
FieldDescription
Upcoming InHow far in advance (in the chosen unit) the job status changes to Upcoming
Due EveryThe time interval at which maintenance becomes Due
UnitDay, Week, or Month

How Calendar-Based Thresholds Work โ€” Example using Upcoming In = 10 days and Due Every = 20 days:

IntervalUpcoming Status Triggered WhenDue Status Triggered When
1stDays since asset creation โ‰ฅ 10 and < 20Days since asset creation โ‰ฅ 20 and < 30
2ndDays since asset creation โ‰ฅ 30 and < 40Days since asset creation โ‰ฅ 40 and < 50
3rdDays since asset creation โ‰ฅ 50 and < 60Days since asset creation โ‰ฅ 60 and < 70

๐Ÿ“Œ Calendar-based maintenance status is always recalculated by the platform on a regular schedule โ€” not in real time.

4. Assets, Checklists, and Partsโ€‹

ItemDescription
AssetsSelect which assets this plan applies to. Only assets accessible to your account are shown.
Planning ChecklistAn optional checklist of tasks that must be completed before a maintenance job can be scheduled. Use this for pre-service inspections or procurement steps.
Completion ChecklistAn optional checklist of tasks that must be completed during the maintenance visit before the job can be closed.
Parts / ProductsReference parts that need to be ordered ahead of the service visit.

โœ… Result: Once saved, the plan automatically generates maintenance records for all assigned assets based on the configured rules. Notifications are sent to all designated contacts when maintenance status changes.


Editing a Maintenance Planโ€‹

Open any plan from the Plan list and click EDIT. All fields โ€” basic information, schedule type, rules, assets, notifications, and checklists โ€” can be updated. Changes take effect immediately and the platform recalculates maintenance status for all affected assets.

Deleting a Maintenance Planโ€‹

Click the delete icon on the plan's row in the Plan list. Deleting a plan removes all associated maintenance rules and notification subscriptions. Historical maintenance records for assets under this plan are preserved.


๐Ÿ”„ Common Workflowsโ€‹

Workflow 1 โ€” Daily Maintenance Checkโ€‹

  1. Open the Dashboard
  2. Review the Status Chart โ€” note any spike in Due items
  3. Scan the Maintenance Reminders List for Due and Upcoming jobs
  4. For Due items: click Schedule Job โ†’ assign a technician and date
  5. For Scheduled items past their date: confirm completion or investigate delay

โœ… Result: Every maintenance item has a clear owner and a planned date, preventing Due jobs from aging into Missed.


Workflow 2 โ€” Completing a Scheduled Jobโ€‹

  1. Open the Dashboard and find the job with Scheduled status
  2. Click Complete Job
  3. If a checklist is required, click Complete Task and work through it first
  4. Upload supporting documentation (work order, photos)
  5. Enter the job number, service date, run hours, and technician notes
  6. Submit โ€” the job moves to Completed and appears in History

โœ… Result: A fully documented maintenance record is created and the asset's service history is updated automatically.


Workflow 3 โ€” Setting Up a New Meter-Based Maintenance Planโ€‹

โž• Create a new plan
โ””โ”€ Enter name, description, and notification contacts
โ””โ”€ Set Schedule Type: Fixed or Offset
โ””โ”€ Add a Meter-Based rule
โ””โ”€ Select sensor group and sensor
โ””โ”€ Set Upcoming In and Due Every thresholds
โ””โ”€ Set Rule Type: Real-Time or Scheduled
โ””โ”€ Assign assets from the dropdown
โ””โ”€ Attach completion checklist (optional)
โ””โ”€ Save

โœ… Result: The platform begins monitoring the selected sensor on all assigned assets and generates maintenance records automatically when thresholds are crossed.


Workflow 4 โ€” Reviewing Maintenance History for an Assetโ€‹

  1. Click History in the sidebar
  2. Use the date range filter to set the review period
  3. Search by asset name to narrow the results
  4. Review the Status column โ€” any Missed records warrant investigation
  5. Click View Details on any record for the full service documentation

โœ… Best Practicesโ€‹

  • ๐Ÿ“… Check the Dashboard daily or weekly. Staying ahead of Due dates prevents maintenance from becoming Missed โ€” which affects both asset reliability and warranty compliance.
  • โฑ๏ธ Complete scheduled jobs within three days. Jobs not completed within three days of their scheduled date automatically revert to Due status. Prompt completion keeps statuses accurate and your team's workload predictable.
  • ๐Ÿท๏ธ Use tags to organize plans at scale. Tag plans by equipment type, facility, maintenance category, or service team so they are easy to search and filter as your plan library grows.
  • ๐Ÿ”ฉ Order parts at the time of scheduling. The Purchase Kit feature in the scheduling dialog is designed for this โ€” using it ensures parts arrive before the service date.
  • ๐Ÿ“ Document thoroughly when completing jobs. Detailed technician notes help the whole team understand what was done and make it easier to identify recurring issues across similar assets.
  • ๐Ÿ“Š Review History periodically. Assets with frequent Missed or off-cycle repairs may need their maintenance plan intervals adjusted, or may indicate a deeper reliability issue worth investigating.

๐Ÿ’ก Tips & Shortcutsโ€‹

TipHow
See only what's urgentUse the Due filter button on the Dashboard to show only overdue items
Find a specific asset quicklyUse the search bar on the Dashboard or History page
Export for external reportingClick Export to CSV on the Dashboard or History page
Order parts without leaving schedulingClick Purchase Kit in the Schedule Job dialog
View full service documentationClick View Details on any History record
Add unplanned repairsClick โž• Add on the Dashboard to create an off-cycle maintenance record


๐Ÿ“Ž Additional Notesโ€‹

  • Document Links: Use the "Document links" (Href) field when creating plans to link to maintenance service manuals.