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 Create 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
Blockchain verificationNoRequests an on-chain anchor (matchain). Enabled on the Pro plan — see the note below.
  1. Click Create Award.

Blockchain anchoring is not yet live

The Blockchain verification checkbox is gated to the Pro plan, but on-chain anchoring is not operational yet. Ticking it does not currently write anything to a chain — the award is created and verifies normally via its public page. Treat this as a preview of a forthcoming feature, not working on-chain verification.

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 row shows the issue date, expiry, recipient name, badge name, and blockchain status, plus a checkbox for bulk selection and a View link. Revoked awards show a red Revoked chip next to the recipient. Click a row (or View) to open the award detail modal.

Award detail modal

The detail modal shows a hero badge view, the description and criteria, the recipient, engagement stats (views, shares, downloads, LinkedIn adds), and a collapsible Award identity accordion (award ID, recipient hash, salt, raw Open Badges JSON). Its actions are:

  • Download PNG (Open Badges baked) — the badge image with the assertion JSON embedded for offline verification.
  • Download PDF certificate — opens the generated certificate.
  • Copy public URL and Open public page — the recipient-facing verification page.
  • Add to LinkedIn — shown when the issuer has a verified LinkedIn Company Page.
  • View on blockchain — shown only once an on-chain anchor has completed.
  • Resend email — re-sends the award notification to the recipient.
  • Share via email — see below.
  • Revoke and Delete — see Revoking & Deleting Awards.

Sending Award Emails

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

  1. Find the award in the list and click it to open the detail modal.
  2. Click Resend email, then confirm.
  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 or space separated, up to 20) and a custom message — they each receive a copy of the badge with a link back to the public verification page. The message is pre-filled from the badge's share text.

Revoking & Deleting Awards

Two ways to withdraw an award:

Revoke

Revoking keeps the award record but marks the credential invalid — the public verification page shows it as revoked and it can no longer be shared. Use this when a credential should be withdrawn but you want to preserve the audit trail.

  • Single: open the award and click Revoke in the detail modal.
  • Bulk: tick the checkboxes for the awards you want, then click Revoke selected in the bulk-action bar.

Either way a confirmation dialog lets you add an optional reason and tick Email the recipient that their credential was revoked. Revoking does not refund the award against your quota.

Delete

Deleting is a hard delete — the award record is removed and its public page stops working. This cannot be undone and does not refund the credit. Open the award and click Delete in the detail modal, then confirm. To keep an audit trail, prefer Revoke instead.

CSV Export

The Export CSV button in the Awards toolbar downloads the currently displayed (filtered) awards as a CSV with these columns: Valid From, Valid To, Recipient Name, Issuer Name, Badge Name.

Awards page with rows selected and Export CSV in the toolbar

Bulk Actions

Selecting one or more rows shows a bulk-action bar above the table (the toolbar stays in place). From it you can:

  • Bulk share via email — email several recipients the same custom message.
  • Revoke selected — revoke every selected award at once (see Revoking & Deleting Awards).
  • Clear — deselect all.

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