Ctrl + P (or Cmd + P) → Save as PDFField intelligence, live — a complete guide to running your operations on TANNAH.
Twelve chapters covering every role, every task, every screen.
What TANNAH is, what it does, and what it does not do.
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:
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 you need, how to log in, and what to expect.
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.
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.
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.
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.
Four roles. Each one sees a different slice of the system.
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.
Each company has at least one Administrator. The Admin:
Admins can see everything inside their own company and nothing inside any other company.
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.
A Promoter is on the ground. The Promoter:
A Promoter cannot see other promoters, other teams, or any company-level data.
Issuing keys, managing companies, publishing terms.
When you log in as Extr, your sidebar shows only these items:
The Extr dashboard is deliberately minimal. You see:
No company names. No user names. No data. Just counts.
A registration key is a one-time code that lets a new company sign up. Every key creates exactly one company, then dies.
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.
If a key was sent to the wrong person, or you generated too many:
The key becomes unusable immediately. If you want to revoke every outstanding key at once, use Revoke all outstanding keys.
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.
If a company was archived by its own Admin and later wants to return:
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.
1.1 for minor, 2.0 for major)Every user who has not accepted the new version is asked on their next login.
Managing users, teams, products, outlets, and everything else inside your company.
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.
Click Accounts in the sidebar. This is where you manage every user in your company.
Find the user, click Edit, change any field except email and role (locked after creation), click Save changes.
Click Deactivate. The user's status flips to deactivated and they cannot log in. Data is preserved. Click Activate to reverse.
tannah.co.ke/reset.html and enter the key + new passwordThe key expires after 72 hours.
A team groups promoters under a supervisor. Every promoter can belong to one team. Every team can have one supervisor.
Products are the items your company promotes.
CC-200ML, add your company's initials or a prefix.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 are the physical locations where promoters check in.
This is where you decide which promoter can sell which product and check in at which outlet.
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.
Two tabs: Sell Out (every sale in the range) and Payroll (days worked × daily rate). Both support date range filtering and XLSX export.
The payroll sheet shows each promoter with name, staff number, ID number, team, days worked, daily rate, total pay, and payment details.
Choose a date range and optionally a team. Click any export card to download an .xlsx file.
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.
Managing a team of promoters.
Shows checked in today, sales today, not checked in, teams count, products, outlets, and quick actions to Check Ins, Payroll, My Team, Notifications.
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.
Same layout as the admin view, restricted to your team's promoters only. You see every check-in of the people you manage.
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.
Read-only view of the company's catalogs. You cannot edit them.
Same as admin, restricted to your team's data.
You can generate one-time reset keys for your own promoters only. Not for other supervisors or admins.
tannah.co.ke/reset.htmlYour day, your sales, your earnings.
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.
Where you start and end each working day.
Your photo is uploaded, your GPS is recorded, and the day begins. You cannot check in twice in one day.
After your shift, return to My Day. Tap Check out now to end your day. Your hours are computed automatically.
Record each sale as it happens:
Report how much of each product you are physically carrying. Update whenever stock changes. Saving sends a notification to your supervisor.
Set daily, weekly, and monthly sales targets. Monthly targets show a progress bar.
A chart of your daily sales over the last 7 days, plus month totals.
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.
Days worked this month, daily rate, total earned, and a list of recent check-ins.
Step-by-step for the tasks you will do most often.
Once you have a reset key:
tannah.co.ke/reset.htmlThe key works once. It expires after 72 hours.
Now they can log in, check in, and sell.
tannah.co.ke/signup.html.xlsxYou are signed out and the company is archived. Data is preserved.
How data leaves the platform and reaches the people who need it.
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.
| Column | Meaning |
|---|---|
| Promoter | Name of the promoter who made the sale |
| Phone | Their contact number |
| Team | Team they belong to |
| Outlet | Where the sale happened |
| Category | Product category |
| SKU | Product code |
| Price/Unit | Sale price per unit |
| Units | Number of units sold |
| Value | Total value (units × price) |
| Column | Meaning |
|---|---|
| Promoter | Name |
| Staff # | Staff number |
| Team | Team name |
| Outlet | Where they checked in |
| Check In | Date and time of check-in |
| Check Out | Date and time of check-out |
| Hours | Hours worked |
| Status | checked in / checked out |
| GPS | Latitude, longitude |
One row per promoter with days worked, daily rate, total pay, and payment details. Grand total at the bottom.
Every user in your company with role, status, team, and contact details.
Static snapshots of your catalogs.
What you agree to when you use the platform.
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 appears at the bottom of the terms page. It contains:
Acceptance is recorded with a timestamp, IP address, and browser identifier.
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.
Read the current terms at any time at tannah.co.ke/terms.html, whether logged in or not.
The full terms cover:
Quick answers to the most common issues.
Sessions expire after 2 hours of inactivity. Log in again. If it happens repeatedly, your browser may be blocking cookies.
Log out and log back in. If it still happens, your role may have changed — ask your Admin.
Products and outlets are visible only if an Admin or Supervisor has assigned them to you.
Frequently asked questions.
Yes. Fully responsive. Promoters typically use phones; admins often use desktop for reports.
No. TANNAH runs in the browser.
No. Location is captured only at the moment of check-in.
No. Only the check-in photo you take is stored.
Your admin can deactivate your account. Historical data remains. Data deletion requests are supported under the Data Protection Act.
Yes.
Yes. Supervisors see everything for promoters in their team.
No. Every query is scoped by company.
Contact your supervisor. In some companies the admin can adjust; in others the day may not count.
Yes — promoters can suggest a product. It goes into the catalog and your supervisor is notified.
Your profile has a daily rate. Your earnings page shows days worked × rate.
Yes — from My Info and My Earnings you see everything TANNAH holds about you.
You cannot check in while the platform is unavailable. Once it is back, resume.
Yes. Bcrypt hashing — the industry standard.
Only your company's Admin.
No. An internet connection is required for all write actions.
A code that works exactly once. Used for registering new companies and resetting passwords.
Because TANNAH published a new version.
Email [email protected].