RecyclingBin

What is RecyclingBin?

RecyclingBin surfaces deleted records in ServiceM8. Thanks to ServiceM8's soft-delete, almost nothing is ever truly gone — records get deactivated rather than removed. RecyclingBin lists those deactivated records and lets you bring any of them back with a single click.

It supports the things you'd expect: jobs, clients, assets, materials, attachments, notes, floor plans, and other soft-deletable record types. Open the add-on, find the record, hit Restore, done.

Opening RecyclingBin

RecyclingBin doesn't attach to individual jobs or clients — it operates account-wide. After installing, find it under Account → Add-ons → RecyclingBin in ServiceM8.

1. From ServiceM8, click Account in the top-right.
2. Click Add-ons.
3. Find RecyclingBin in your installed add-ons and click it.
4. RecyclingBin opens and starts loading your deleted items.

The Deleted Items List

When RecyclingBin opens, you'll see a list of recently deactivated records, sorted with the most recently deleted first. Each row shows:

• Type pill — what kind of record it is (Job, Client, Asset, Note, Attachment, Material, etc.)
• Name or detail — the record's name, job number, or summary so you can tell what it is at a glance
• Date — when it was deactivated
• Restore button — click to bring it back

By default RecyclingBin loads the last 7 days. If you need to go further back, use the load more control at the bottom of the list.

Restoring a Record

1. Find the record you want to restore in the list. Use the search box or type filter to narrow things down if there's a lot.
2. Click the green Restore button on its row.
3. RecyclingBin reactivates the record in ServiceM8 immediately.
4. The row updates inline — you'll see a green Restored tick and strikethrough text so you know it's back and you don't try to restore it again.

The record is now active in ServiceM8 again, with all its original data intact (including UUIDs, attachments, history and any relationships).

Search & Filter

The deleted list can get long, so RecyclingBin gives you two tools to narrow it down:

• Search — type any part of the name, job number or detail. The list filters as you type.
• All types dropdown — pick a record type (Jobs only, Clients only, Attachments only, etc.) to hide everything else.

Combine the two to zero in on a specific record fast.

Refresh

If new items have been deleted since you opened RecyclingBin, click the Refresh button (top-right) to pull the latest list from ServiceM8.

What Can & Can't Be Restored

RecyclingBin can restore anything ServiceM8 soft-deletes. That includes:

• Jobs and quotes
• Clients and contacts
• Assets
• Materials and material bundles
• Attachments (photos, PDFs, signed forms)
• Notes
• Floor plan and PDF Floor Plan attachments (PinDrop)

If ServiceM8 truly removes a record from its database (rare but it happens for some record types), RecyclingBin can't bring that back — once it's gone, it's gone.

Tips

• RecyclingBin only shows what's actively deactivated. If a record was previously deactivated and then re-activated, it won't show up here.
• Restored records keep their original UUID, so any cross-references (asset-to-job, attachment-to-job, etc.) just work.
• The "Couldn't check Supplier" message at the bottom is normal — some record types intentionally aren't checked because they don't get soft-deleted.
• Use the type filter when you know what you're looking for — it's much faster than scrolling.

Permissions RecyclingBin Needs

RecyclingBin requests the following ServiceM8 OAuth scopes:

• Read & manage jobs — to list deactivated jobs and reactivate them.
• Read & manage customers — for deactivated clients and contacts.
• Read & manage assets — for deactivated assets.
• Read & manage attachments — for deleted attachments and floor plans.
• Read & manage inventory / materials — for deactivated materials and bundles.
• Read & manage notes — for deleted notes.
• Vendor — for analytics tracking only. Sends only your organisation name to Over Geek for usage reporting.

Privacy & Security

RecyclingBin reads and writes directly to your ServiceM8 account. Record data never touches any third-party server. We only receive a small usage ping (organisation name and event name) for analytics — no record content. See our Privacy Policy for full details.

Need Help?

If you run into any issues or have questions, get in touch and we'll sort you out.

Get Help