Uploading Beneficiaries to Program (User Manual)

Uploading Beneficiaries to Program (User Manual)

The Upload Beneficiaries feature in openIMIS allows you to bulk import individuals into a selected program. This is especially useful for onboarding large groups such as households or individuals from a national registry.

Step-by-Step Instructions

1. Open the Program

  • Go to the Programs list.

  • Click on the desired program (e.g., 009 GOLF HEALF) to open it.

2. Click "UPLOAD"

  • In the lower right of the screen (just above the beneficiary list), click the UPLOAD button.

3. Select File

  • In the Upload Beneficiaries pop-up:

    • Click "Choose File" to open a file browser.

    • Select a valid .csv or .xlsx file containing the beneficiary data.

4. Set Workflow (Optional)

  • In the Workflow field, choose a predefined workflow if required.

    • This determines how uploaded beneficiaries are processed (e.g., automatically activated or marked for review).

    • Leave blank if no specific workflow is needed.

5. Download a Template (Optional but Recommended)

  • Click the TEMPLATE button to download a blank file with correct headers and structure.

  • Fill in the data in the downloaded template and save it before uploading.

6. Upload the Beneficiaries

  • Once the file is selected and workflow (if any) is set:

    • Click UPLOAD BENEFICIARIES to begin the process.

If the button is disabled, make sure a file is selected.


Validation & Feedback

  • The system will automatically validate the data in your file.

  • If errors are detected (e.g., missing fields, invalid dates), a message will be shown.

  • Correct the errors in your file and repeat the upload.


Example Fields in Template

Column Header

Description

Required

Column Header

Description

Required

First Name

Beneficiary's first name

✅

Last Name

Beneficiary's surname

✅

DOB

Date of Birth (YYYY-MM-DD)

✅

Gender

M / F / O

✅

ID Number

National or scheme ID

✅

Region

Administrative region

✅


After Upload

Once uploaded:

  • Beneficiaries will appear in the LIST tab of the program.

  • You can use the SEARCH or FILTERS to verify the uploaded records.

To track past uploads, click the UPLOAD HISTORY tab.


Troubleshooting Tips

Problem

Solution

Problem

Solution

Upload button is disabled

Ensure a file is selected and format is supported (.csv, .xlsx)

Validation failed

Check for missing required fields or incorrect data types

File not uploading

Try a smaller batch first and verify network connectivity