Getting started
Everything every office user needs: getting your account, logging in, and the parts of the screen that work the same way on every page. Field surveyors should read the Field Surveyor guide instead.
Before you start
- You need an invitation. There is no public sign-up. An administrator adds you on the Staff page and you receive a one-time link by email, or from the administrator directly (for example by WhatsApp).
- Use an up-to-date browser: Chrome, Edge or Firefox on a computer. The office app also works on a tablet; the field app is made for phones.
- Your role decides what you see. Menus, buttons and steps you are not allowed to use are hidden. If something in this guide is missing for you, your role does not include it — see If something is missing.
Accept your invitation
- Open the link in the invitation. It works once and for 7 days.
- Check that your name, email and role are right. If the role is wrong, stop and ask your administrator.
- Choose a password of at least 8 characters and type it again.
- Click Set password. You are logged in straight away. Field surveyors are shown the address of the field app instead.
The link has been used, has expired, or was replaced by a newer one. Ask your administrator for a New invitation link. See This link is invalid or has expired.
Log in
Go to the office app address and enter your work email and password.
- Your session lasts 12 hours. After that you are asked to log in again; nothing you saved is lost.
- If your role is for field surveys only, the office app refuses the log-in and tells you to use the field app on your phone.
Forgot your password
- On the log-in screen, click Forgot your password?
- Enter your work email and click Send reset link.
- Open the link in the email within 1 hour and choose a new password.
If the system cannot send email, the screen says so: ask your administrator for a Password reset link from your staff record instead.
Finding your way around
- The menu on the left lists the pages your role can open: the Dashboard and the Map, then Registers (projects, properties, claimants, compensation, in the order the work flows), Work queues (fill the gaps, conflicts, spatial flags, surveys), Outreach and Administration. A number beside a page is the work waiting there for you (red when it is blocking a case). Click a group's heading to fold it; Collapse menu at the bottom shrinks the menu to icons.
- The top bar shows where you are, the find box, the Working on project, and your name, staff ID and role. Click your name to open My account.
- The find box (or Ctrl K, or /) finds any case, property, claimant or project by its reference, name or phone number, and jumps to any page. Without typing, it lists the files you opened recently.
- Working on: pick a project and every register (properties, claimants, compensation, the work queues) opens filtered to it, and the dashboard counts that project's work. Choose All projects to go back.
- The dashboard is the first page for most roles. It opens on Waiting for you: one line for each step your role can take (cases to value, to approve, cheques to issue…) with how many are waiting and a Start button. Every other count on it is a link to the matching list.
- Help & guide at the bottom of the menu opens this guide; Shortcuts (or ?) lists the keyboard shortcuts.
Working through a list
Open a file from any register, then use the arrows on the file's left edge, or J (next) and K (previous), to move through the list as it is filtered, without going back to it. For example, filter the compensation cases to Valuated, open the first, approve it, and press J for the next. The row of the open file stays marked in the list, so closing the file leaves you where you were.
Side panel or page
A record's file (a property, claimant, case, project, survey, conflict, message, staff member or dictionary) opens in the side panel over its list, or as a page of its own. Use Open as page or Side panel in the file's header to switch at any time: the same tab stays open. Your choice is remembered for that kind of record, so if you prefer cases as pages, every case opens as a page from then on. A page has its own address (for example #/compensations/12?tab=evidence), and on a page J / K still move through the list you came from, Esc returns to the list, and printing gives the record without the menu.
Registers show their main filters in one row; More filters opens the rest (a filter that is in use always stays in view). Compact rows at the foot of a register fits more rows on a laptop screen. Both are remembered on your computer.
| Key | What it does |
|---|---|
| Ctrl K or / | Find a record or page |
| N | New record on this page (register property, new project…) |
| F | Search this register |
| J / K | Next / previous record while a file is open |
| G then D, P, C, K, M, J | Go to Dashboard, Properties, Claimants, Compensation, Map, Projects |
| Esc | Close the file or dialog on top |
Every view has its own address. Filters, sorting and the open record are kept in the address bar (for example #/compensations?status=disputed&open=12), so you can bookmark a view or send the link to a colleague. They see the same view if their role allows it.
Registers: lists of records
Projects, properties, claimants, surveys, compensation cases, conflicts, spatial flags, messages and staff are all kept in registers that work the same way.
- Search looks through the whole register on the server, not just the page you can see.
- Filters narrow the list. Long dropdowns, and every LGA › ward › area list, can be searched: open one and start typing. Clear filters appears once a filter is set.
- Sort by clicking a column heading; click again to reverse.
- Tick rows to act on several records at once (assign surveys, send a message, export only those rows). Ticks are kept as you change pages.
- Pages: choose 10, 25, 50 or 100 rows per page.
- Export downloads exactly what the register shows, as Excel or CSV. See Import and export.
- The property and claimant registers have a Data column: how complete each record is, as a percentage. Filter by Data, Missing or Captured to find records that need work. See Data completeness.
Asking in plain words
When your organisation has switched AI suggestions on, you can ask for records in words instead of setting filters one by one: AI Ask… in a register’s filter bar, or type a question in the find box (Ctrl K) and choose Ask: “…”. For example:
- approved cash cases in DEMO-KEB over ₦1m
- properties in KCH-S01 missing a front photo
- claimants without bank details registered last week
The right register opens with the filters set, and a note says how your question was read (and any part it could not use). The filters are ordinary filters: check them and change them as you like. Only your question and the list of filters are sent — no records. See AI suggestions.
Saved views
Filters you use again and again — “approved cash cases in Kachia”, “claimants missing bank details” — can be saved under a name. Set the filters (and the sort), click Views in the filter bar, type a name and Save the view. Tick Share to offer it to everyone who can open that register.
- Your views, and those shared with you, are in the menu under MY VIEWS: one click opens the register with those filters. They are ordinary filters: change them as you like.
- Views also lists the register’s saved views, with Share / Stop sharing and Delete for your own. A view keeps the filters, not the records: it always shows what matches today.
Record files
Click a row to open its file, which slides in from the right. The address gains ?open= so the file can be bookmarked. Close it with the cross, the Esc key, or the browser’s Back button.
- The heading starts with the record’s reference:
KSR-008for a property,CL-0012for a claimant,S-0007for a survey,COMP-KSR-2026-01-0003for a compensation case,K-0004for a conflict,M-0001for a message. - Property and claimant files show a Data completeness checklist: what is in place, what is missing, and a button to fix each gap.
- The next-step box says what the record needs next and, if your role can do it, gives you the button.
- Actions sit in the footer. The amber button is always the next step in the process.
The minute sheet
Every file has a Minutes tab: the numbered history of everything done to the record, newest first, with the date, time and person. Minutes cannot be edited or deleted. Opening a sensitive number, exporting full numbers, sending a message and every change of status are all minuted.
Masked numbers
Bank account numbers, BVNs, NINs and ID numbers are shown as ••••6789 everywhere. Roles with the permission to reveal see a Reveal button; each reveal is recorded on the claimant’s minute sheet. Other roles see a padlock.
Evidence and documents
Properties, claimants, surveys and cases each have an Evidence tab (Photos on a survey). Click Attach document, choose the kind of document, and pick a file:
- JPG, PNG, WEBP or PDF, up to 15 MB each.
- Kinds of document:
My account
Click your name in the top bar. You can change your photo, name and phone number, and your password. Your email can only be changed by an administrator.
Logging out and shared computers
- Click Log out at the bottom of the menu when you leave a shared computer.
- Closing the tab does not log you out: the session stays on that computer for up to 12 hours.
If something is missing
A page, button or step you expect is not there? Your role does not include it. Opening an address for a page you cannot use takes you to the first page you can.
- See which permissions your role has: My account › Your access.
- See which permission each action needs: Roles and permissions.
- Ask an administrator to change your role, or the role itself.