Skip to main content

How to report bugs

Report bugs in Superset with clear steps, screenshots, and device details so our team can reproduce and fix issues faster

Agatha Beise avatar
Written by Agatha Beise
Updated this week

Bug reports help us reproduce an issue, understand impact, and ship a fix. You can report bugs via the chat or by email at [email protected].

Follow these steps

  1. Reproduce the issue one more time (if possible) and note what you did right before it happened.

  2. Open Supersetbottom-right cornerChat with support (or email [email protected]).

  3. Add a short summary: what’s broken + where in the app it happens.

  4. Include Steps to reproduce (numbered) and what you expected vs. what actually happened.

  5. Add your environment details:

    • Device (iPhone model / Android model / Mac / Windows)

    • OS version (iOS/Android version)

    • If the app is up to date

    • Platform: Web / iOS / Android

  6. Attach proof:

    • Screen recording (best) or screenshots

    • If it’s visual (layout/scroll), include the whole screen

Notes & best practices

  • If it’s intermittent, tell us how often it happens (example: “1 out of 5 times”).

  • If it blocks clients, say that upfront so we can prioritize.

  • If you see an error message, copy/paste it exactly (screenshots help too).

  • For data issues (missing workouts, wrong dates), include the client email and approx time it happened.

  • If possible, try once on Wi-Fi vs. cellular (mobile) and mention the result.

FAQ

What’s the difference between a bug and a feature request?

A bug is something that’s supposed to work but doesn’t. A feature request is new behavior you want added.

Do I need a screen recording?

Not always, but it’s the fastest path to a fix - especially for UI issues, crashes, and “it’s weird” bugs.

What if I can’t reproduce it?

Still report it. Share what you were doing right before it happened and how often you’ve seen it.

Can I report bugs for my clients too?

Yes - include the client email and what they were trying to do (and ask them for a screen recording if possible).

Did this answer your question?