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
Programslist.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
UPLOADbutton.
3. Select File
In the Upload Beneficiaries pop-up:
Click "Choose File" to open a file browser.
Select a valid
.csvor.xlsxfile 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
TEMPLATEbutton 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 BENEFICIARIESto 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 |
|---|---|---|
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 |
|---|---|
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 |