Skip to content

Policyholders ​

The policyholder register is the book of insured pastoralists. You enrol people into an area with their livestock, browse and search the roster, import in bulk, and open any person to see their cover, edit them, archive them, or send them an SMS.

Before you start ​

The active data source needs its insurance setup done first, because onboarding captures a head count for each insured livestock type. If no active livestock has been defined, the platform tells you to set that up before enrolling anyone.

Reading the register ​

  • Summary cards: how many policyholders, areas, livestock types, and mobile-money providers are in the book.
  • Filters: search by name, phone, or national ID; filter by area or provider; and a Show archived toggle.
  • Table: each policyholder with their area, TLU (their herd as a single comparable number), a summary of their livestock, their mobile-money provider, and their status (active or archived).

Onboard one policyholder ​

Open Onboard and capture:

  • Full name and phone (required: the phone is used for both payouts and SMS),
  • optional gender, mobile-money provider, national ID, and email,
  • the area (UAI) they belong to,
  • and a head count for each insured livestock type.

As you enter the herd, a live preview shows the total TLU and the resulting sum insured (their total TLU times the sum insured per TLU). Saving creates the record and opens it.

Import policyholders in bulk ​

The Import wizard takes a spreadsheet through three steps:

  1. Upload a CSV of policyholders.
  2. Map its columns to name, phone, area, provider, and a column per livestock type (the wizard guesses the mapping for you).
  3. Review: it validates every row, shows how many are ready versus skipped and why, and lets you commit the valid ones.

Open a policyholder ​

The detail page shows:

  • Profile: contact details, area, mobile-money provider, and enrolment date.
  • Cover: total TLU and total sum insured, broken down by livestock type.
  • SMS history: messages sent to this person.
  • Actions: Send SMS (composes a message to just this person), Edit, and Archive (hides them from the active register but keeps them on file).

How the register connects ​

  • Cover comes from insurance setup: each person's total TLU times the sum insured per TLU.
  • Payouts: a payout run pays these policyholders: their phone, provider, and sum insured are exactly what a run needs.
  • Messaging: the register is the audience for broadcasts; you can target everyone, an area, or a provider.

Troubleshooting ​

SituationWhat to do
Onboarding blocks on livestockDefine at least one active livestock type in Insurance setup.
Cover shows "-"No sum insured per TLU is set for the book, set it in Insurance setup.
A person isn't in the listThey may be archived, turn on Show archived.