🔐 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
  • Single field, multiple values: sector → wash,protection
  • Multiple fields: Filter field will be empty, value shows: sector=wash;province=gaza
  • 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, sector, province
  • Single field, multiple values: sector → wash,protection
  • Multiple fields: Leave filter_field empty, use sector=wash;province=gaza in filter_value
  • Multiple fields with multiple values: sector=wash,protection;province=gaza,rafah

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 (can be empty for multi-field)
partial_view_filter_value
Filter value(s) or field=value pairs
partial_edit
Edit filtered submissions
partial_edit_filter_field
Filter field for edit (can be empty for multi-field)
partial_edit_filter_value
Filter value(s) or field=value pairs
partial_delete
Delete filtered submissions
partial_delete_filter_field
Filter field for delete (can be empty for multi-field)
partial_delete_filter_value
Filter value(s) or field=value pairs
partial_validate
Validate filtered submissions
partial_validate_filter_field
Filter field for validate (can be empty for multi-field)
partial_validate_filter_value
Filter value(s) or field=value pairs

Example Users in Template

steve_kobo - Full Admin
Has all permissions to view, edit, manage, and validate everything
bob_kobo - Single Field Filter
Can view form and add submissions. Partial view/edit/validate for sector=wash
alice_viewer - Own Submissions Only
Can only view submissions she created (_submitted_by=alice_viewer)
multi_field_user - Multiple Fields
Can view where sector=wash OR protection AND province=gaza (demonstrates multiple filter fields)

🚀 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...