Platform User Manual
[Legacy v3] User Manual
[Legacy v3] User Manual
  • [Legacy v3] Ushahidi Platform User Manual
  • Navigating the Ushahidi Platform User Manual
  • About Ushahidi
  • Overview of Ushahidi Platform v3.0
    • Technical Specifications
  • 1. Installing Ushahidi Platform
  • 2. Setting up a deployment
    • 2.1 Upgrading/Downgrading your deployment plan
  • 3. Configuring your deployment
    • 3.1 Accessing your deployment
    • 3.2 General Settings
    • 3.3 Surveys
    • 3.4 Data Sources
    • 3.5 Categories
  • 4. Managing People on your deployment
    • 4.1 Roles
    • 4.2 Users
  • 5. Modes for visualizing and managing data on your deployment
    • 5.1 Map View
    • 5.2 Data view
    • 5.3 Activity view
  • 6. Managing Data in your deployment
    • 6.1 Viewing Posts
    • 6.2 Filtering Posts
    • 6.3 Adding Posts
    • 6.4 Editing Posts
    • 6.5 Translating Posts
    • 6.6 Publishing Posts
    • 6.7 Deleting Posts
    • 6.8 Importing Data
    • 6.9 Exporting Data
      • 6.10 HDX integration
  • 7. Managing your Donations
    • 7.1 Donations
  • 8. Analysing Data on your deployment
    • 8.1 Saved Searches
    • 8.2 Collections
  • 9. Additional Links
Powered by GitBook
On this page
  • Video setup guide
  • Setup Guide
  • 4.1.1 Add Role
  • 4.1.2 Edit Role
  • 4.1.3 Delete Role
  1. 4. Managing People on your deployment

4.1 Roles

Previous4. Managing People on your deploymentNext4.2 Users

This feature allows you to set up and manage default and custom roles and permissions for different user groups on your deployment. Each deployment has a default “Admin” and "Member" role, which cannot be deleted, but can be edited. The default “Admin” role allows for full control over ALL functionality on your deployment, while the default "Member" role only grants access to edit their own posts.

The setup in this guide is demonstrated in the below video as well. You can watch and follow the guide at the same time!

Video setup guide

Setup Guide

To access the roles management page,

  • On the left hand menu bar, click on Settings

  • Then, click on Roles

  • You’ll be redirected to a page with a list of all existing roles - default & custom roles (created by admins if any exist).

4.1.1 Add Role

To add a custom user role,

  • Click on the yellow Add icon

  • Add the following details

    • Name: Provide a name for this new custom role

    • Description: Provide a brief description of what/who this custom role has been created for

    • Set your permissions. Below is a brief breakdown of what permissions get granted to users on selecting the options provided.

      • Manage Users: Allows for;

        • Viewing Users

        • Adding, Editing, Deleting Users

        • and Changing roles for Users

      • Manage Posts: Allows for;

        • Viewing posts

        • Editing and Deleting Posts

        • Publishing posts (Setting specific audiences to view )

        • Adding posts to collections

        • Creating new collections

      • Manage Settings: Allows for managing;

        • General Settings

        • Map Settings

        • Data Sources

        • Surveys

        • Categories

      • Bulk Data import and Export: Allows for upload of data via CSV files and exporting files.

      • Edit their own posts: Allows for editing of posts submitted by user

      • Manage collections and saved searches: Allows for

        • Addition posts to all saved searches/collections on

        • Removing posts from all saved searches/collections

        • Editing all saved searches/collections

        • Deleting all saved searches/collections

  • Click on Save.

See the illustration below

4.1.2 Edit Role

To edit a role

  • Click on a role from the list provided to you.

  • Click on Save to update the role.

4.1.3 Delete Role

To delete a role

  • Click on a role from the Roles management list page

  • Then, click on the Delete This Role button at the bottom of the page

  • A pop up box will appear on the top of the page, prompting you to confirm whether you would like to delete the custom role. If

    • You would like to proceed with deletion, click on Delete

    • You would not like to proceed with deletion, click on Cancel

On redirection to the edit page, make your desired changes to the role (i.e fill out details as directed in the section)

Add role
How to manage default and custom roles
Settings button on the Ushahidi Platform sidebar.
Settings list page. Roles button highlighted.
Click on the red yellow + button to add a new role.
The add role page contains a role name, description, and preferred permissions.
Click on a role from the Role
Adding details to a new role. Name, description and permission fields available.
Selecting a role in the roles list.
Click the DELETE THIS ROLE button.
Delete role confirmation pop up