Skip to main content

Permissions

Permissions let the app collect data from plugins.

What you will do​

  • Check which permissions your plugins need
  • Enable permissions on your phone
  • Confirm data collection after permission changes

Steps​

1) Know the common permissions​

Common plugin needs:

  • Surveys: notifications (for reminders)
  • Health: health data access (platform specific)
  • Sensors: motion, location, Bluetooth (depends on the plugin)

Your study may not need all permissions.

2) Allow permissions during onboarding​

When the app asks, tap Allow. If you tap Do not allow, you can enable it later.

3) Enable permissions in phone settings​

  • iOS: Settings - App - Permissions (wording can change by iOS version)
  • Android: Settings - Apps - (your app) - Permissions

4) Re-check plugin status​

After changing permissions:

  • Re-open the app.
  • Open the plugin status page (if your app has one).
  • Run a small test (survey completion or sensor movement).

5) Logs for permission problems​

If a plugin shows "No data" or "Permission denied":

  • Export app logs from the app (if available)
  • Note the exact time you tested

For CLI export problems, check CLI logs:

  • macOS and Linux: ~/.modtrack/logs/
  • Windows: %APPDATA%\\modtrack\\logs\\

Common mistakes​

  • Denying a permission once and forgetting to enable it later
  • Turning on a plugin but not enabling its permission
  • Using battery saver mode or "pause app activity"

Report issues​

Include:

  • Plugin name (surveys, health, sensors)
  • Permission status (screenshots help)
  • App logs and the time you tested