Skip to content

Issuing Badges

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

Awards list

Creating a Single Credential

  1. Open the Credentials page from the sidebar.
  2. Click Create Credential. 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
  1. Click Create Credential.

Each successful credential counts as one against your annual credential pool (Free: 1,200/year, Starter: 12,000/year, Pro: 120,000/year). The pool resets on your account's registration anniversary; billing stays monthly. See Plans & Billing for details.

Badge Picker

When creating a credential, 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 Credentials

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

  • Filter by issuer — select an issuer to show only their credentials.
  • 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 — credentials 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, and badge name, plus a checkbox for bulk selection and a View link. Revoked credentials show a red Revoked chip next to the recipient. Click a row (or View) to open the credential 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 Credential identity accordion (credential 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.
  • Resend email — re-sends the credential notification to the recipient.
  • Share via email — see below.
  • Revoke and Delete — see Revoking & Deleting Credentials.

Sending Credential Emails

After creating a credential you can email it to the recipient at any time:

  1. Find the credential 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 a Credential by Email

Inside the credential 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 Credentials

Two ways to withdraw a credential:

Revoke

Revoking keeps the credential 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 credential and click Revoke in the detail modal.
  • Bulk: tick the checkboxes for the credentials 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 credential against your quota.

Delete

Deleting is a hard delete — the credential record is removed and its public page stops working. This cannot be undone and does not refund the credit. Open the credential 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 Credentials toolbar downloads the currently displayed (filtered) credentials 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 credential at once (see Revoking & Deleting Credentials).
  • Clear — deselect all.

Bulk Share modal with multiple recipients

Next Steps

badges.ninja Documentation