How to report a bug (read before posting)

Found something broken? Post it here.

The Totem team monitors this category daily. Critical bugs — data loss, sync failures, crashes on launch — are escalated immediately, so flag those clearly in your title.

What to include

The more detail you give us, the faster we can reproduce and fix it. Copy and fill in this template:


Platform: Mac / Windows / iOS
OS version: e.g. macOS 14.4, Windows 11 23H2, iOS 17.3
Totem version: Find this under Totem > About (or Settings > About on iOS)

What happened:
Describe what you saw.

What I expected:
What should have happened instead.

Steps to reproduce:
1.
2.
3.

Does it happen every time? Yes / No / Sometimes

Anything else:
Screenshot, screen recording, whether restarting Totem changes anything, whether teammates can reproduce it.


You don’t need all of this for every report. A rough description of what happened is always worth posting — we can ask follow-up questions.

Severity guide

If your issue involves any of the following, please say so prominently in your title:

  • Data that appears to be lost or corrupted
  • Sync that has been stuck for more than a few minutes
  • A crash that prevents you from opening Totem
  • Permissions behaving incorrectly (users seeing things they shouldn’t, or can’t see things they should)

These get triaged out of the normal queue.

Not sure if it’s a bug?

Post it anyway. The worst case is we tell you it’s working as intended and explain why. Better than sitting on something that turns out to be a real issue.