Bulk issuance by CSV
Award a whole cohort at once: the template, every column, and what happens when a row fails.
Open a badge and switch to the bulk tab. Upload a CSV and every valid row becomes an award.
Start from the blank template
Download it from the bulk tab, or directly at /api/csv-template. It has the exact column headers in the right order, which removes the most common cause of a failed import.
Columns
| Column | Required | What it does |
|---|---|---|
email | Yes | Recipient's email address. Must be a valid address; it's lowercased and used to detect duplicates. |
name | No | Recipient's name, shown on the claim page and in the email greeting. |
evidence_url | No | A link to evidence for this recipient. |
evidence_name | No | A short label for that evidence item. |
evidence_description | No | A sentence describing it. |
evidence_narrative | No | Longer context — what the recipient actually did. |
evidence2_url | No | A second evidence item, same idea. |
evidence2_name | No | Label for the second item. |
evidence2_description | No | Description for the second item. |
evidence2_narrative | No | Narrative for the second item. |
Two evidence slots, and no file uploads
CSV supports up to two link/text evidence items per row. Uploaded files are single-issuance only. If a cohort needs file evidence, issue those awards individually.
Limits and failures
- 1,000 rows per upload. Split larger cohorts across several files.
- Rows are processed independently. One bad row doesn't stop the run — the rest still issue.
- Failures are reported per row with the reason, so you can fix just those and re-upload. Common causes: malformed email, a recipient who already holds the badge, or hitting your plan's annual limit partway through.
- Re-uploading is safe. Anyone who already holds an active award is rejected as a duplicate rather than issued twice.
Check your headroom first
If your cohort is larger than the issuing allowance left on your plan for the calendar year, the run will stop partway. Your usage and limit are shown in Settings → Plan & billing.
Related
Still stuck?
Email us at hello@incredify.net — a human will answer.