Browse all guides

Add in-app reporting with the SDK

The in-app SDK puts a Report a problem form inside your app or game. People fill in a short form and can add a screenshot. Each report arrives in your Support intake lane as a ticket, with the app version, device and screen it came from.

Use it when you want feedback from the people using your product, without asking them to find a website or write an email.

What you need

  • A subscription plan that includes the Support module.
  • Support set up for the project. The public Customer support portal can be on or off; the SDK does not need it.
  • Project owner or admin access to create keys.

Create a key

  1. Open the project's Settings → Support → In-app SDK.
  2. Enter a name, such as iOS app or Godot game.
  3. Choose Production for real reports, or Test while you build. Test reports arrive as [Test] tickets with low priority.
  4. Optional: limit the key to your websites (for example https://app.example.com) or app IDs (bundle IDs or Android package names).
  5. Select Create key and copy it.

A key can only read your report form and send reports. It cannot read tickets or send email, so it is safe to ship inside your app. If a key is misused, select Revoke. It stops working straight away. Create a new key first if you want to swap keys without a gap.

Add the SDK to your app

All platforms come from one repository, krffl/tododdle-support, and share one version number. The In-app SDK tab shows the install and setup code for each platform with your key filled in.

PlatformInstall
iOS (Swift)Swift Package Manager: add https://github.com/krffl/tododdle-support and the TododdleSupport library.
Android (Kotlin)JitPack: com.github.krffl.tododdle-support:support-compose.
FlutterA git dependency on the repository with path: flutter.
React Nativenpm install @krffl/tododdle-support-react-native
Webnpm install @krffl/tododdle-support
Godot 4Copy godot/addons/tododdle_support into your project, enable the plugin and set the key in Project Settings.

Each SDK has a ready-made report form that follows your project's settings, and a headless client if you want to build your own form.

Choose what the form asks

In the same tab, under the report form:

  • Turn report types on or off: Report a problem, Share feedback and Ask a question, and rename them.
  • Make the title optional or required, and change the labels.
  • Add up to 20 extra fields: short text, long text or a choice list.
  • Allow or turn off attachments, and change the button and thank-you wording.

Apps pick up changes the next time they open the form. You do not need to release an app update.

What a report looks like

Each report becomes a Support case and a ticket in your intake lane, so lane rules and automations run as they do for other requests. The ticket shows:

  • the type, title, description and your extra fields;
  • app context: platform, app version and build, operating system, device and screen;
  • any screenshot or file the person chose to add;
  • the reporter's name, email or customer reference if your app sent them.

Reports are one way

  • The person gets no email, no sign-in link and no replies. The ticket offers internal notes only.
  • Names and emails come from your app and are not checked. The ticket marks them Unverified.
  • To follow up with someone, use the contact details you already have for them in your own product.

Privacy

The SDK collects nothing by default. Screenshots and files are attached only when the person chooses to add them, and they see a preview first. Reports never include URL query strings, contacts or location. ToDoddle keeps only a short-lived, scrambled form of the sender's network address for rate limits.

Limits

  • 120 reports an hour for each key, 10 an hour from one network address and 1,000 a day for each project.
  • Up to 5 files per report, 10 MB each: PNG, JPEG, WebP, GIF, PDF or plain text.
  • Over a limit, the SDK waits and tries again, or tells your app when to retry.

Updated 2026-11-10. Owned by product.