Creating Badges

A badge is a credential template that describes an achievement, skill, or certification. Each badge belongs to a verified issuer and can be awarded to multiple recipients. Badges follow the Open Badge v2.0 BadgeClass specification.

Creating a New Badge

1. Open the Badges page from the sidebar.
2. Click New Badge. The full-screen create modal opens with the designer on the left and the form sidebar on the right:

3. Select the issuer that will award this badge. Only verified issuers are shown. 4. Fill in the required fields:

Field	Required	Description
Name	Yes	Badge title (e.g. "Cloud Architecture Certified")
Description	Yes	What the badge represents
Criteria	Yes	What the recipient did to earn this badge
Image	Yes	Badge image — use the Badge Designer or upload your own

5. Click Create.

The badge image is uploaded to IPFS for permanent, decentralized storage. The badge is now ready to be awarded.

Viewing Badge Details

Click on any badge in the list to see its full details:

• Badge name, description, and criteria
• The issuer it belongs to
• Badge image (stored on IPFS)
• Number of awards issued for this badge
• Date created

Viewing Badge Detail

Click any badge card to open its detail view — the same popup used for editing, so you can inspect and modify in one place:

Editing a Badge

Badge create and edit use the same popup, so editing feels exactly like creating:

1. Click on the badge in the list.
2. The full editor opens — change any of:
   • Name — the badge title
   • Description — what the badge represents
   • Criteria — the earning requirements
   • Image — open the Badge Designer or upload a new image (the previous IPFS image remains accessible at its CID, so existing awards keep showing the original art)
   • Share text (see below)
3. Click Save.

Edits apply to the badge template going forward. Existing awards retain the badge data from the moment they were issued — recipients never see a credential change after the fact.

Share Text

Every badge has a default share text shown to recipients on the public share page and used as the message pre-filled when they post to LinkedIn, X, Facebook, WhatsApp, Telegram, or email. You can customize it from the same popup as the rest of the badge:

• Plain text only — HTML tags are rejected.
• Keep it short (around 200 characters) so it fits inside social-media post limits.
• Default if left blank: I just earned the {badge name} from {issuer name}!

Tips

• Name first, then design — give the badge a clear name so it surfaces well in the recipient portal and on the public verification page.
• Criteria sells the badge — recipients (and verifiers) read this field to understand what was actually earned.
• One badge, many awards — design once and award to thousands. Use Bulk Awards when you have a CSV of recipients.

Deleting a Badge

1. Click on the badge you want to delete.
2. Click Delete.
3. Confirm the deletion.

A badge can only be deleted if it has no awards. The dashboard pre-checks the award count and surfaces it in the confirmation dialog. To delete a badge that has been awarded, first delete its awards (or simply leave the badge in place — it costs nothing to keep).