Users
The Users tab of Users & roles lists the people in your organisation who can sign in to the ITS portal. From here an administrator adds a colleague, gives them roles, changes their details and their e-mail address, resets a lost second factor and records where a customs officer is posted.
You never see, choose or type anyone's password here. A new colleague sets their own password from an e-mail the sign-in service sends them.
Who can open this screen
Anyone whose role reads users: System admin, Secretariat admin and Organisation admin. Each sees only their own organisation's people: the Secretariat sees the Secretariat's accounts, Uganda sees Uganda's, and a REC such as the Arab Maghreb Union (AMU) sees its own.
| Operator (System admin) | Secretariat admin | State Party or REC administrator | |
|---|---|---|---|
| Users and Roles tabs | Both | Both | Users only. There is no Roles tab. |
| Bulk upload, Add user | Shown | Shown | Shown |
| Row menu | Edit, and Reset second factor and Deactivate on other people's accounts | The same | The same |
| The roles you may give | Secretariat admin, Organisation admin, Customs officer, Departure authority, Partner | The same | A State Party: Customs officer, Departure authority. A REC: Customs officer |
| Secretariat | State Party | REC |
|---|---|---|
![]() | ![]() | ![]() |
Before you start
- You need a role that manages users. See What each role can do.
- Have ready: the person's first and last name, their work e-mail address, the username they will sign in with, and the roles their job needs. A phone number and a staff ID are optional.
How to open it
- Select Users & roles in the header.
- The Users tab opens.

On the page
| On the page | What it is for |
|---|---|
| Users, Roles | Switch between people and roles. Shown only to someone who may open both: the operator and the Secretariat admin. |
| Bulk upload | Add many people from a spreadsheet. See Add many people at once. |
| Add user | Add one person. See Add a user. |
| Search by name, e-mail or username… | Narrows the list when you press Enter or leave the box. |
| Status | All (the list opens on this, deactivated people included) or Active only. |
| Sort | Newest first, E-mail address or Surname. |
| Clear filters | Shown while a search or Active only is narrowing the list. It empties the search box and puts Status back to All. Sort stays as you set it. |
| User | Initials, name and e-mail address. |
| Roles | The roles the person holds, three at most with + and a number for the rest. Roles that belong to systems rather than people are never shown here. |
| Status | Active, Provisioning, Provisioning failed or Deactivated. |
| ⋮ (User actions) | Edit, Reset second factor and Deactivate on an active account, or Activate on a deactivated one. You cannot reset your own second factor or deactivate yourself, so those two are not offered on your own row. |
Under the list, the page shows the total number of users and Items per page, with buttons to move between pages.
If an account never finished being created, a notice above the list says so: "One account below never finished provisioning and cannot sign in. Nothing will retry on its own." That person's status reads Provisioning failed.
Select a row to open the person's panel on the right.

| Panel section | What it shows |
|---|---|
| Account | E-mail address, Username, Phone, Staff ID, Created, and the Identity provider subject (the sign-in service's identifier for the person). The phone number is shown spaced the way it is dialled. |
| Roles | The roles held, with Edit. No roles. This person can sign in but do nothing. means exactly that. Holds only system roles, which are managed outside this console. means the account belongs to a system, not a person. |
| Duty stations | Where a customs officer is posted, with Add to record a posting. A posting is a record for your administration: stamping is not affected either way. |
Add a user
-
Select Add user at the top right.

-
Type the First name and Last name.
-
Type the E-mail address. The set-password e-mail goes here.
-
Type the Username the person will sign in with. It cannot be changed later.
-
Optionally type a Phone number. See The phone number.
-
Optionally type a Staff ID: the number your organisation knows the person by.
-
Select the Roles box (Select roles…) and pick one or more roles. Only the roles your organisation may give are listed (see the table above). See Roles and permissions for what each grants.

-
Select Add user, or Cancel to close the window and keep nothing.
The fields
| Field | Required | What to enter |
|---|---|---|
| First name | Yes | Given name, up to 150 characters. |
| Last name | Yes | Family name, up to 150 characters. |
| E-mail address | Yes | A valid work e-mail address. It can be changed later. See Change a person's e-mail address. |
| Username | Yes | The sign-in name. Cannot be changed afterwards. |
| Phone | No | A number that can be dialled in the country you choose. |
| Staff ID | No | Your organisation's own number for the person, up to 80 characters. |
| Roles | Yes | At least one role. |
A required field left empty is refused under the field: A first name is required, A last name is required, Enter a valid e-mail address, A username is required or Choose at least one role.
The phone number
The Phone field has a Country button in front of the number. No country is chosen for you.
- Select Country, type in Search country… and pick the country. The field then shows an example number in that country's format.
- Or type the number starting with
+and the dialling code, for example+256. The country is picked for you as soon as the code is complete. - The field stops taking digits once the number is as long as a number in that country can be.
ITS keeps the number in international form, for example +256700000001. A
number that cannot be dialled in the chosen country is refused with Enter a
valid phone number for the selected country.
A number saved before the field had a country list is kept as it is when you save other changes. It is checked only if you change it.
What happens next
A User created message confirms the account, with one of two sentences:
- "An invitation to set a password has been sent to" the person's address. The sign-in service has e-mailed them a link to set their password.
- The address "was linked to an existing identity". The person already had a sign-in, so they use the password they have and no invitation is sent.
No password is created in the portal and none is ever shown.
The invitation link works for a limited time, which the Secretariat sets as Invitation link lifespan under Operations on Settings. A person whose link has expired uses Forgot password? on the sign-in form.
Under Roles, the window says: "Only the roles you may grant are listed. Which roles those are depends on your kind of organisation (Secretariat, State Party or REC), not on the roles you hold yourself." The Secretariat may give Organisation admin, for example, without holding it. If ITS still refuses a role, the message names the roles you may give.
Edit a user
-
In the person's ⋮ menu, select Edit, or select Edit beside Roles in their panel.

-
Change the name, e-mail address, phone, staff ID or roles. The Username is greyed out.
-
Select Save changes, or Cancel.
A Profile updated message confirms a change to the details, E-mail address changed a new address, and Roles updated a change to the roles.
The details, the address and the roles are saved separately. If one part is refused, the window stays open and says which part was saved: "The e-mail address was changed. The other details did not save — try again from this dialog." or "The profile was saved. The role change did not apply — try it again from this dialog."
Roles starts with the roles the person holds that you may give. Add or remove roles there. What you see is what the person will hold when you save, together with the roles described below.
- Also holds, which you may neither grant nor remove: lists roles the person holds that your organisation cannot give, for example Organisation admin on a colleague of a State Party administrator. They stay on the account when you save. Only the Secretariat can change them.
- A role the person holds that has since been withdrawn from ITS is listed under Roles too, so you can remove it.
- Roles that belong to systems are never shown, and are kept when you save.
If the person holds only roles you cannot change, the Roles box reads None you can change. Add one… and is not marked as required: the roles under Also holds already count. You can save a change to their details without giving them another role.
Change a person's e-mail address
Type the new address in E-mail address in the Edit user window and select Save changes. The window explains what follows: "A changed address takes effect at once: they sign in with the new one, and it becomes their username when their username was the address. Nobody is e-mailed about the change."
- The new address is saved first. If another person already has it, nothing is saved and the field says That address already belongs to another person.
- Tell the person yourself: ITS does not.
Reset a person's second factor
Use this when a colleague has lost their second factor (their authenticator app or the e-mailed code) and their recovery codes, so they can no longer sign in.
-
In the person's ⋮ menu, select Reset second factor.
-
Read the window Reset second factor for name? Under What happens it says:
- "They are signed out on every device."
- "Their authenticator app or e-mailed code stops working, and so do their recovery codes."
- "They set up a second factor again the next time they sign in."
It adds: "Their password does not change."
-
Select Reset second factor, or Cancel.

A Second factor reset message confirms it: "They have been signed out and set a second factor up again at their next sign-in."
Reset second factor is not offered on your own row. To change your own second factor while you still have it, select Change my second step in your account menu.
Deactivate or reactivate a user
- In the person's ⋮ menu, select Deactivate.
- Read Deactivate this user? and confirm with Deactivate. The window says: "Name loses access immediately. They stay in the directory as deactivated and can be reactivated — nobody is ever deleted, because their name is on stamps that must keep resolving."
A User deactivated message confirms it: "They stay in the directory and can be reactivated." The person stays in the list with the status Deactivated.
To restore access, find the person (the list shows deactivated people unless Status is on Active only) and select Activate in their ⋮ menu. User reactivated confirms it.
There is no password reset on this screen. A person who has forgotten their password uses Forgot password? on the sign-in form.
ITS refuses to deactivate the last active Secretariat admin or Organisation admin of an organisation, because nobody inside it could give the role back.
Record a duty station
-
Open the officer's panel by selecting their row.
-
Under Duty stations, select Add.
-
Fill in the posting:
Field Required What to enter Country Yes The two-letter country code of the border post, for example UG.Station Yes The post's three-character station code, for example BUSfor Busia.From No The date the posting starts. Left empty, ITS dates it itself. Once a date is set, the × in the field clears it. -
Select Record posting, or Cancel.
Posting recorded confirms it. A posting records which border post an officer works at. It does not change what they may stamp.
To end a posting, select Withdraw on it and confirm Withdraw this posting?. Posting withdrawn confirms it, and the posting stays on the record, tagged Withdrawn.
Add many people at once
Bulk upload opens Upload users in bulk: download a template, fill it in offline, then upload it. The window lists the rules:
- First name, last name and e-mail address are required on every row.
- Each e-mail address must be unique. A person already provisioned is reported rather than re-invited.
- Roles must be ones this organisation already has. The workbook lists them in a drop-down.
- Everyone provisioned is sent an invitation, so upload only people who should receive one now.
Rows are provisioned one by one, so a bad line costs only its own row.
| Message | What it means |
|---|---|
| Import complete | Every row was imported, and each person has been sent an invitation. The message gives the number. |
| Import finished with failures | Some rows were imported and some were not. The message gives both numbers; correct the failed rows and upload them again. |
| Nothing was imported | The file held no data rows. Check that you uploaded the filled-in copy and not the blank template. |
Related pages
- Roles and permissions
- What each role can do
- Settings: the invitation link's lifespan.
- Bring a colleague on board

