Press Ctrl + P (or Cmd + P) → Save as PDF
T
TANNAH
Complete User Guide

The TANNAH
System

Field intelligence, live — a complete guide to running your operations on TANNAH.

Contents

Twelve chapters covering every role, every task, every screen.

CHAPTER 01

Introduction

What TANNAH is, what it does, and what it does not do.

What TANNAH Is

TANNAH is a field-intelligence platform. It tracks what happens on the ground — who checked in, where, when, what they sold, and how much stock they hold — and turns that raw activity into dashboards, reports, and payroll data.

It is designed for:

The Core Idea

Every action in the field is verified by two things:

Together, these two proofs mean no one can fake a check-in from home. The photo shows a real person at a real outlet. The GPS shows a real location. Neither can be spoofed easily.

Once a promoter is checked in, everything else flows: sales are logged against that check-in, payroll is computed from completed check-ins, and reports are built from the accumulated data.

What TANNAH Is Not

CHAPTER 02

Getting Started

What you need, how to log in, and what to expect.

What You Need

How to Reach the Platform

Open your browser and go to:

https://tannah.co.ke/login.html

The Login to Console button is also on the public site at https://tannah.co.ke.

First-Time Login

  1. Enter your email address
  2. Enter your password
  3. Click Sign in

If this is your first login and TANNAH has published a Terms of Service version you have not yet accepted, you will be redirected to a Terms page. Read the summary, scroll through the full document, tick the acceptance checkbox, and click I accept. You will then be taken to your dashboard.

Forgot Your Password?

There is no self-service password reset. Contact your Administrator. If you are an Administrator, contact your platform operator (the Extr account holder). They will generate a one-time reset key for you.

After You Log In

The dashboard you see depends on your role. The sidebar on the left shows only the pages you have permission to access. The top bar shows your name, role, and a menu toggle. If you are on a phone, the sidebar is collapsed by default — tap the hamburger icon at the top-left to open it.

CHAPTER 03

Understanding Roles

Four roles. Each one sees a different slice of the system.

Extr — The Platform Operator

The Extr is the highest level. There is only one Extr account per installation. The Extr:

The Extr's role is licence issuance. Nothing more.

Admin — The Company Manager

Each company has at least one Administrator. The Admin:

Admins can see everything inside their own company and nothing inside any other company.

Supervisor — The Team Manager

A Supervisor is assigned to one or more teams. The Supervisor:

Supervisors are the middle layer. They manage the field but they do not own the company.

Promoter — The Field Worker

A Promoter is on the ground. The Promoter:

A Promoter cannot see other promoters, other teams, or any company-level data.

CHAPTER 04

The Extr Account

Issuing keys, managing companies, publishing terms.

What You See

When you log in as Extr, your sidebar shows only these items:

The Dashboard

The Extr dashboard is deliberately minimal. You see:

No company names. No user names. No data. Just counts.

Generating a Registration Key

A registration key is a one-time code that lets a new company sign up. Every key creates exactly one company, then dies.

  1. Click Keys in the sidebar
  2. Click + Generate Key
  3. Set an expiry — typically 30 days, or 1–365 days if you need shorter or longer
  4. Click Generate key

The key appears once, in a copyable box. Copy it immediately. You will never see it again. If you lose it, revoke it and generate another.

Give the key carefully. Anyone who has it can create a company. Send it by direct message, not in a public channel.

Revoking a Key

If a key was sent to the wrong person, or you generated too many:

  1. Click Keys in the sidebar
  2. Find the key by its prefix (first 8 characters)
  3. Click Revoke

The key becomes unusable immediately. If you want to revoke every outstanding key at once, use Revoke all outstanding keys.

Viewing Companies

Click Companies in the sidebar. You see an anonymized table with Company ID, Created date, Status, and Active users count.

You cannot see the company's name, its Admin's email, its products, or its sales. This is intentional.

Deleting a Company

Permanent. Deleting a company removes everything it owned — users, teams, products, stock, check-ins, sales, notifications. There is no recovery.
  1. Click Companies
  2. Find the company by ID
  3. Click Delete
  4. Type the company ID into the confirmation prompt
  5. Confirm

Restoring a Company

If a company was archived by its own Admin and later wants to return:

  1. Click Companies
  2. Find the archived company
  3. Click Restore

Managing Terms of Service

Click Terms of Service in the sidebar. You see the current version, total active users, accepted/pending counts, breakdown by role, and full version history.

Publishing a New Version

  1. Click Publish New Version
  2. Enter the version number (e.g. 1.1 for minor, 2.0 for major)
  3. Set an effective date
  4. Enter a title
  5. Paste the full markdown body
  6. Click Publish version

Every user who has not accepted the new version is asked on their next login.

CHAPTER 05

The Administrator

Managing users, teams, products, outlets, and everything else inside your company.

The Dashboard

Your dashboard shows a welcome bar, teams count, promoters count, checked-in-today count, sales today in KES, active promoters, supervisors, products, and outlets. Quick-start cards link to common tasks.

Accounts

Click Accounts in the sidebar. This is where you manage every user in your company.

Adding a User

  1. Click + Add Account
  2. Choose the account type: Promoter, Supervisor, or Admin
  3. Fill in full name, email, phone, ID number, KRA PIN, password
  4. If Promoter: staff number, team, daily pay, payment path, payment number
  5. Click Save account
Validation rules: ID number must be digits only. KRA PIN must be 1 letter, 9 digits, 1 letter (e.g. A123456789B). Phone must be digits. M-Pesa number must be 254XXXXXXXXX.

Editing a User

Find the user, click Edit, change any field except email and role (locked after creation), click Save changes.

Deactivating a User

Click Deactivate. The user's status flips to deactivated and they cannot log in. Data is preserved. Click Activate to reverse.

Rule: The last active admin in a company cannot be deactivated. Promote someone else first if you need to leave.

Resetting a User's Password

  1. Find the user, click Reset password
  2. A modal appears with a 32-character key
  3. Copy it immediately — you will not see it again
  4. Send the key to the user
  5. They go to tannah.co.ke/reset.html and enter the key + new password

The key expires after 72 hours.

Teams

A team groups promoters under a supervisor. Every promoter can belong to one team. Every team can have one supervisor.

Creating a Team

  1. Click + New Team
  2. Enter team name (unique within company), team code (unique within company), and optionally a supervisor
  3. Click Create team

Products

Products are the items your company promotes.

  1. Click + Add Product
  2. Enter SKU (unique code), name, category, minimum stock, initial stock
  3. Click Save product
SKU must be globally unique across the platform. If another company already used CC-200ML, add your company's initials or a prefix.

Editing Stock

Click Edit stock on any row, enter the new quantity, click OK. Stock represents what your company holds in inventory — separate from what each promoter carries.

Outlets

Outlets are the physical locations where promoters check in.

  1. Click + Add Outlet
  2. Enter outlet name (unique across platform) and location
  3. Click Add outlet

Assignments

This is where you decide which promoter can sell which product and check in at which outlet.

  1. Find the promoter, click Manage
  2. Tick products and outlets this promoter should access
  3. Click Save changes
Critical: A promoter with zero assignments cannot check in or record sales. Ensure at least one product and one outlet are assigned before their first shift.

Check Ins/Outs

Date-filtered log of every check-in and check-out. Change date, search by promoter or team, and click View to open the check-in photo.

Reports

Two tabs: Sell Out (every sale in the range) and Payroll (days worked × daily rate). Both support date range filtering and XLSX export.

Payroll

The payroll sheet shows each promoter with name, staff number, ID number, team, days worked, daily rate, total pay, and payment details.

Exports

Choose a date range and optionally a team. Click any export card to download an .xlsx file.

Project Manager

Where you end your company's project. Clicking End current project archives the company, signs everyone out, and locks you out until the Extr restores it. Data is not deleted — everything stays intact.

CHAPTER 06

The Supervisor

Managing a team of promoters.

The Dashboard

Shows checked in today, sales today, not checked in, teams count, products, outlets, and quick actions to Check Ins, Payroll, My Team, Notifications.

My Team

See each of your teams with editable name and code, and a list of every promoter in the team with their staff number, email, daily pay, and status. Edit name/code and click Save to persist.

Check Ins/Outs

Same layout as the admin view, restricted to your team's promoters only. You see every check-in of the people you manage.

Payroll

Each promoter in your team with days worked in the selected period, daily rate, total pay, and payment details. Filter by date and click Apply.

Products and Outlets

Read-only view of the company's catalogs. You cannot edit them.

Exports

Same as admin, restricted to your team's data.

Password Reset

You can generate one-time reset keys for your own promoters only. Not for other supervisors or admins.

  1. Find the promoter
  2. Click Reset password
  3. Copy the key
  4. Send it to them
  5. They use it at tannah.co.ke/reset.html
CHAPTER 07

The Promoter

Your day, your sales, your earnings.

The Dashboard

Shows sales today, units sold today, daily pay, day status (not checked in / checked in at HH:MM / day complete), and quick actions to My Day, My Sales, My Performance.

My Day

Where you start and end each working day.

Checking In

  1. Allow location access when the browser asks
  2. Select your outlet (only assigned outlets appear)
  3. Tap the photo box and take a photo (or pick one from your gallery)
  4. Tap Check in

Your photo is uploaded, your GPS is recorded, and the day begins. You cannot check in twice in one day.

Checking Out

After your shift, return to My Day. Tap Check out now to end your day. Your hours are computed automatically.

My Sales

Record each sale as it happens:

  1. If not checked in, you are told to check in first
  2. Select a product (only assigned products appear)
  3. Enter price per unit in KES
  4. Enter units sold
  5. Total computes automatically
  6. Click Save sale

My Stock Hold

Report how much of each product you are physically carrying. Update whenever stock changes. Saving sends a notification to your supervisor.

My Target

Set daily, weekly, and monthly sales targets. Monthly targets show a progress bar.

My Performance

A chart of your daily sales over the last 7 days, plus month totals.

My Info

Your personal profile: name, email, phone, ID number, KRA PIN, staff number, team, daily pay, and payment details. Read-only — ask your supervisor if anything is wrong.

My Earnings

Days worked this month, daily rate, total earned, and a list of recent check-ins.

Your Daily Routine

Arrive at outlet
→
Open My Day
→
GPS + Photo
→
Check in
→
Record sales
→
Update stock
→
Check out
CHAPTER 08

Common Tasks

Step-by-step for the tasks you will do most often.

How to Reset a Password

Once you have a reset key:

  1. Go to tannah.co.ke/reset.html
  2. Enter the key
  3. Enter the new password twice
  4. Click Reset password

The key works once. It expires after 72 hours.

How to Add a New Promoter

  1. Accounts → + Add Account
  2. Choose Promoter, fill in details, Save
  3. Assignments → find the promoter → Manage
  4. Tick products and outlets
  5. Save changes

Now they can log in, check in, and sell.

How to Sign Up a New Company

  1. Extr generates a key
  2. Extr sends the key to the new company's admin
  3. Admin goes to tannah.co.ke/signup.html
  4. Enters the key + details
  5. Company and admin are created; admin is auto-logged in

How to Export Data for Accounting

  1. Exports
  2. Set the date range to the accounting period
  3. Click the report (Sell Out, Payroll, etc.)
  4. File downloads as .xlsx

How to End a Project

  1. Project Manager
  2. Click End current project
  3. Confirm twice

You are signed out and the company is archived. Data is preserved.

CHAPTER 09

Reports and Exports

How data leaves the platform and reaches the people who need it.

Understanding the Date Range

Every report uses a date range. Default is the current month. Reports use the date the check-in occurred, not the date the sale was recorded. A sale at 12:02 AM on the 1st belongs to the previous day's check-in.

Sell Out Report

ColumnMeaning
PromoterName of the promoter who made the sale
PhoneTheir contact number
TeamTeam they belong to
OutletWhere the sale happened
CategoryProduct category
SKUProduct code
Price/UnitSale price per unit
UnitsNumber of units sold
ValueTotal value (units × price)

Check Ins Report

ColumnMeaning
PromoterName
Staff #Staff number
TeamTeam name
OutletWhere they checked in
Check InDate and time of check-in
Check OutDate and time of check-out
HoursHours worked
Statuschecked in / checked out
GPSLatitude, longitude

Payroll Export

One row per promoter with days worked, daily rate, total pay, and payment details. Grand total at the bottom.

Accounts Export

Every user in your company with role, status, team, and contact details.

Products and Outlets Exports

Static snapshots of your catalogs.

CHAPTER 10

Terms and Conditions

What you agree to when you use the platform.

When You See Them

The first time you log in, if you have not accepted the current version of TANNAH's Terms of Service, you are redirected to terms.html before you can reach the dashboard.

The Accept Bar

The accept bar appears at the bottom of the terms page. It contains:

Acceptance is recorded with a timestamp, IP address, and browser identifier.

New Versions

When TANNAH publishes a new version, you are asked to accept it on your next login. You do not need to accept again for minor clarifications, but you do for anything that changes the substance of the agreement.

Reading Them Anytime

Read the current terms at any time at tannah.co.ke/terms.html, whether logged in or not.

What You Are Agreeing To

The full terms cover:

CHAPTER 11

Troubleshooting

Quick answers to the most common issues.

I Cannot Log In

I See "Session expired"

Sessions expire after 2 hours of inactivity. Log in again. If it happens repeatedly, your browser may be blocking cookies.

My Check-In Photo Will Not Upload

My GPS Says "Location Unavailable"

The Site Looks Wrong on My Phone

"Permission denied" on a Page I Should Have

Log out and log back in. If it still happens, your role may have changed — ask your Admin.

I Cannot See a Product or Outlet

Products and outlets are visible only if an Admin or Supervisor has assigned them to you.

Numbers Look Wrong

CHAPTER 12

FAQ

Frequently asked questions.

Can I use TANNAH on my phone?

Yes. Fully responsive. Promoters typically use phones; admins often use desktop for reports.

Do I need to install an app?

No. TANNAH runs in the browser.

Does TANNAH track my location all the time?

No. Location is captured only at the moment of check-in.

Can my admin see my personal photos?

No. Only the check-in photo you take is stored.

What happens to my data if I leave the company?

Your admin can deactivate your account. Historical data remains. Data deletion requests are supported under the Data Protection Act.

Can I log in on multiple devices?

Yes.

Can my supervisor see my sales?

Yes. Supervisors see everything for promoters in their team.

Can other companies see my data?

No. Every query is scoped by company.

What if I forget to check out?

Contact your supervisor. In some companies the admin can adjust; in others the day may not count.

Can I add a product myself?

Yes — promoters can suggest a product. It goes into the catalog and your supervisor is notified.

How do I know how much I will be paid?

Your profile has a daily rate. Your earnings page shows days worked × rate.

Can I download my own data?

Yes — from My Info and My Earnings you see everything TANNAH holds about you.

What if TANNAH goes down?

You cannot check in while the platform is unavailable. Once it is back, resume.

Is my password encrypted?

Yes. Bcrypt hashing — the industry standard.

Who can see my KRA PIN?

Only your company's Admin.

Can I use the platform offline?

No. An internet connection is required for all write actions.

What is a "one-time key"?

A code that works exactly once. Used for registering new companies and resetting passwords.

Why do I need to accept the Terms again?

Because TANNAH published a new version.

Where do I send feedback?

Email [email protected].

TANNAH
Where Execution Meets Intelligence and Delivers Experience.
[email protected]