Bulk Rewards — Rewards System

CSV Format

The bulk award CSV file must follow a strict format. The system validates the entire file before applying any awards — invalid rows block the entire batch.

Column	Format	Rules
`publisher_id`	Integer	Must match an active publisher account in the system. Invalid IDs block the batch.
`points`	Positive integer	Must be between 1 and 10,000. Negative values are not permitted in bulk awards.
`reason`	String, minimum 20 chars	Free text. Do not include commas in the reason field unless the field is enclosed in quotes. Use the same reason for all publishers in a program, or customize per row.

Example CSV content:

publisher_id,points,reason
1042,250,"Q2 2026 beta testing program — completed all 5 test sessions"
1087,250,"Q2 2026 beta testing program — completed all 5 test sessions"
1103,150,"Q2 2026 beta testing program — completed 3 of 5 test sessions"
1219,250,"Q2 2026 beta testing program — completed all 5 test sessions"

Bulk Award Process

Open Bulk Rewards in Rewards Management — Select "Bulk Award" from the reward type options.

Upload CSV — Upload the prepared CSV file. The system immediately runs validation.

Review validation results — The system displays a preview table showing all rows: publisher name, points, reason, and any validation errors. Rows with errors are highlighted in red. The batch cannot proceed if any row is invalid.

Fix errors and re-upload if needed — If validation errors exist, fix the CSV and re-upload. There is no partial processing — all-or-nothing.

Confirm batch — After successful validation, confirm the batch. If any individual award exceeds 500 pts, those rows enter the pending approval queue. The rest are credited immediately.

Results summary — After processing, the system shows a results summary: total publishers awarded, total points issued, and any rows that went to pending approval. The summary can be downloaded as a report.

Approval Rules for Bulk Awards

Per-Publisher Award in Batch	Processing
1 – 500 pts	Credited immediately on batch confirmation
501 – 10,000 pts	Enters pending approval queue — credited only after a second admin approves each individual award

Each row is an individual award in the audit log

Bulk awards are processed as individual awards — each publisher's award is logged separately in the audit trail with the same fields as a manual award (publisher ID, points, reason, issuing admin, timestamp). The batch is linked by a batch ID, so admins can filter the audit log to see all awards from a specific batch.

Notification to Publishers

Publishers in a bulk award batch receive the same notification as manual award recipients — an in-platform notification and email with the point amount and the reason text from the CSV row. There is no indication in the publisher notification that the award was part of a bulk batch rather than an individual award.

← Tier Promotions Next: Pending Approval →