# Bulk Award Assignment

### Overview

Bulk Award Assignment enables administrators to grant recognitions to large groups efficiently using file-based uploads. This capability is designed to support recurring recognition cycles, organizational milestones, and high-volume award scenarios while maintaining validation, auditability, and consistency with existing recognition workflows.

<figure><img src="/files/Bt55JAFbHGftlknMRnjc" alt="" width="563"><figcaption></figcaption></figure>

***

### Bulk Assignment Setup

The process follows a guided flow that begins with downloading a standardized CSV or spreadsheet template. Administrators populate this file with recipient information, award details, giver identification, and optional context such as subject, message, and associated core values. Once uploaded, the system processes the file and begins awarding recognitions automatically.

After upload initiation, a confirmation message indicates that processing has started. Ongoing status and completion details are available through the **Import Logs** area, allowing administrators to monitor progress without remaining on the upload screen.

***

### Import Rules and Processing Behavior

Bulk award assignment supports CSV, XLS, and XLSX file formats and allows flexible recipient definitions. A single row can include multiple recipients using comma-separated employee identifiers, and awards can be assigned at the individual or team level. Guest users can also be included where applicable. Recipient matching is handled case-insensitively, with leading and trailing spaces automatically trimmed to reduce formatting errors.

Each row in the file is validated independently. If a row contains missing required identifiers, such as employee email, employee ID, or team name, that row is skipped while remaining rows continue processing. If any recipient listed within a single row is invalid, the entire row fails to ensure consistent award delivery. Organizational award frequency or restriction rules are bypassed for bulk imports to allow administrative flexibility during large-scale recognition events.

When an award is submitted on behalf of a giver who does not have sufficient reward points, the standard approval workflow is applied automatically. This ensures financial and governance controls remain intact without interrupting the bulk assignment process.

***

### Import Auditing and Logs

Bulk award assignments are fully auditable through Import Logs, which include a dedicated recognition entry type. Each import record captures the original file name, the administrator who initiated the import, the date and time of submission, and the overall processing status. Logs display counts of successful and failed rows and provide access to detailed, row-level results for troubleshooting and verification.

Administrators can review processing outcomes directly within the log details and download the original uploaded file when needed. This audit trail supports operational transparency, error resolution, and compliance review for recognition programs conducted at scale.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.mangoapps.com/admin-guide/module-settings/recognition/bulk-award-assignment.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
