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 Create 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 Badge.

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

Viewing Badge Details

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

The detail view shows:

• Badge name, description, and criteria
• The issuer it belongs to
• Badge image (stored on IPFS)
• Share text (see below)

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 Update Badge.

Awarded badges are editable too. When a badge already has awards, the editor opens with an amber banner explaining that your changes apply to future awards only — every already-issued award embeds a snapshot of the badge as it was at issue time, so recipients never see a credential change after the fact. (The issuer is locked once a badge exists.)

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 share their award 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.

• The field is seeded with this default template when you create a badge:

  Excited to share that I just received the "{{badge_name}}" certification!
  
  Thanks to {{issuer_name}} for this awesome recognition.
  
  {{award_url}}

Placeholders

Share text supports tokens that the backend substitutes per recipient at share time (never in the editor). Click + Insert placeholder above the field to drop a token in at the cursor:

Token	Replaced with
	The recipient's name
	The badge name
	The issuer name
	The issue date
	The public award URL

When creating a badge, a Reset to default template link restores the seeded text if you've edited it.

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 in the editor.
3. Confirm the deletion.

A badge can only be deleted if it has no awards. If awards exist, the confirmation dialog does not appear — instead an inline red error tells you the badge still has issued awards and can't be deleted yet. To remove such a badge, first clear its awards from the Awards page (revoke or delete each award), then return here to delete the badge. Or simply leave the badge in place — it costs nothing to keep.