Skip to content

Awarding Badges

An award (also called an assertion) is a badge issued to a specific person. Each award records who earned the badge, when it was issued, and provides a unique verification URL. Awards follow the Open Badge v2.0 Assertion specification.

Awards list

Creating a Single Award

  1. Open the Awards page from the sidebar.
  2. Click New Award. The creation form opens:

New Award form

  1. Select the badge using the Badge Picker — clicking Select a badge… opens a visual card grid that shows every badge image + name. Search by name, description, or issuer.

Badge Picker overlay 4. Fill in the recipient details:

FieldRequiredDescription
NameYesRecipient full name (minimum 5 characters)
EmailYesRecipient email address
Issued OnYesThe date the credential was earned
ExpiresNoOptional expiration date
BlockchainNoOptional on-chain anchor (matchain). Available on the Pro plan.
  1. Click Create.

Each successful award counts as one against your monthly award quota (Free: 100/mo, Starter: 1,000/mo, Pro: 10,000/mo). The quota resets at the start of each billing period. See Plans & Billing for details.

Badge Picker

When creating an award, you select the badge through a visual picker:

  • Badges are displayed as cards with the badge image and name.
  • Click a badge card to select it.
  • Only badges from verified issuers are shown.
  • You can scroll through all your badges or search by name.

Viewing Awards

The awards list shows all awards you have issued. You can:

  • Filter by issuer — select an issuer to show only their awards.
  • Filter by badge — select a specific badge to narrow results.
  • Search by recipient — toggle between Name and Email search modes (server-side, case-insensitive).
  • Paginate — awards are loaded 50 at a time using cursor-based pagination. Click Load More to fetch the next page.

Each award row shows the badge image, recipient name, issue date, and status. Click a row to open the award detail modal, which includes a hero badge view, the criteria, the recipient identity (accordion), engagement stats (page views, share clicks), and quick actions to resend the email, copy the verification link, or download the PDF certificate.

Award detail modal

Sending Award Emails

After creating an award you can email it to the recipient at any time:

  1. Find the award in the list.
  2. Click the Send icon on the row, or open the award and use Resend email in the detail modal.
  3. The recipient gets the badge image, criteria, and a link to the public verification page.

Sharing an Award by Email

Inside the award detail modal, click Share via email to open the share sub-modal. Enter one or more recipient emails (comma-separated) and a custom message — they each receive a copy of the badge with a link back to the public verification page.

CSV Export

The Export CSV button in the Awards toolbar downloads the filtered view as a CSV (award id, badge name, recipient name + email, issue / expiry dates, verification URL). If you've multi-selected rows, the bulk-action bar replaces the toolbar:

Awards page with rows selected and Export CSV in the toolbar

Bulk Sharing

To email several recipients the same custom share text, select the rows on the Awards page and click Bulk share via email:

Bulk Share modal with multiple recipients

Next Steps

  • Bulk Awards — award badges to many recipients at once via CSV upload
  • Sharing & Verification — learn about public verification, PDF certificates, and social sharing
  • Recipient Portal — what your recipients see when they sign in to collect their badges

badges.ninja Documentation