🔐 KoboToolbox Bulk Permission Updater

Update permissions for multiple users across your KoboToolbox assets

⚙️ Configuration

Find your token in KoboToolbox: Account Settings → Security
Used for updates. Optional for export (if provided, excludes owner from export).

📤 Export Current Permissions

Download existing permissions as TSV template

📋 How to Export

  • Fill in the Configuration section above
  • Click "Export Permissions" to download current permissions
  • The file will be in the same format as the template
  • Note: Multiple filter values are comma-separated (e.g., val1,val2,val3)
  • Make your changes in Excel/Google Sheets
  • Upload the modified file below to update permissions

Exporting...

📋 Permission Template

Download the blank template to get started

📌 Template Guide

  • Use TRUE or FALSE for all permission columns
  • Full permissions (e.g., view_submissions) grant access to ALL submissions
  • Partial permissions require both the permission flag AND filter field/value
  • Don't use both full and partial for the same action (they're mutually exclusive)
  • Common filter fields: _submitted_by, organization, region
  • Multiple filter values: Separate with commas: org1,org2,org3

Template Columns (21 total)

username
KoboToolbox username
view_form
View form design
edit_form
Edit form design
manage_project
Full project management
add_submissions
Add new submissions
view_submissions
View all submissions
edit_submissions
Edit all submissions
delete_submissions
Delete all submissions
validate_submissions
Validate all submissions
partial_view
View filtered submissions
partial_view_filter_field
Filter field for view
partial_view_filter_value
Filter value for view
partial_edit
Edit filtered submissions
partial_edit_filter_field
Filter field for edit
partial_edit_filter_value
Filter value for edit
partial_delete
Delete filtered submissions
partial_delete_filter_field
Filter field for delete
partial_delete_filter_value
Filter value for delete
partial_validate
Validate filtered submissions
partial_validate_filter_field
Filter field for validate
partial_validate_filter_value
Filter value for validate

Example Users in Template

steve_kobo - Full Admin
Has all permissions to view, edit, manage, and validate everything
bob_kobo - Partial Access
Can view form and add submissions. Can view and validate only where organization=bar
alice_viewer - Own Submissions Only
Can only view submissions she created (_submitted_by=alice_viewer)

🚀 Update Permissions

Copy and paste from the downloaded template (Excel/Google Sheets)
Example (copy from template): username view_form edit_form manage_project add_submissions view_submissions... steve_kobo TRUE TRUE TRUE TRUE TRUE...

Processing...