Skip to content

Managing Issuers

An issuer is the organization or individual that awards badges. Every badge must belong to a verified issuer. Issuers follow the Open Badge v2.0 Issuer Profile specification.

Issuers list with a verified ACME issuer

Creating a New Issuer

  1. Open the Issuers page from the sidebar.
  2. Click New Issuer. The creation form opens:

New issuer form

  1. Fill in the required fields:
FieldRequiredDescription
NameYesOrganization name (minimum 3 characters)
URLYesOrganization website (must start with http:// or https://)
EmailYesContact email for the issuer (used for verification)
LogoNoUpload an image for the issuer profile (shown on cards and public award pages)
LinkedIn Organization IDNoNumeric ID of your LinkedIn company page — enables the Add to LinkedIn Profile button on every public award page
  1. Click Create.

New issuer form filled out

Each plan includes a maximum number of issuers (Free: 1, Starter: 5, Pro: unlimited). Creating an issuer is free as long as you stay within your plan's limit.

LinkedIn Add-to-Profile

If you fill in the LinkedIn Organization ID field on an issuer, every public award page issued under that issuer gets an Add to LinkedIn Profile button. Recipients click it once and the credential lands directly in the Licenses & Certifications section of their LinkedIn profile — no manual copy-paste.

To find your LinkedIn organization ID:

  1. Go to your company's LinkedIn page as an admin.
  2. Look at the URL — it's the numeric portion after /company/ if you use the legacy format, or visible in the page admin URL.
  3. Paste it into the issuer's LinkedIn Organization ID field and save.

This is the single biggest lever for badge share rates — recipients are far more likely to share a credential when adding it to LinkedIn is one click instead of three.

Editing unverified issuers

You can edit any field of an issuer until it has been verified. Once verified, the name, URL, and email are locked to keep the credential record stable — but you can still update the logo and LinkedIn organization ID.

Issuer Verification

Issuers must be verified before you can create badges under them. There are two verification methods:

Auto-verification

If the issuer email matches your account email, the issuer is verified automatically when created. No additional action is needed.

Email verification

If the issuer email is different from your account email:

  1. A verification email is sent to the issuer email address.
  2. The email contains a verification link with a unique code.
  3. Click the link in the email to verify the issuer.
  4. A confirmation page appears when verification succeeds.

If the email never arrives, open the issuer in the dashboard and click Rotate verification code to invalidate the previous link and send a fresh one.

You can also verify programmatically via the API using the verification code. See Issuers API for details.

Viewing Issuer Details

Click on any issuer in the list to view its details:

  • Issuer name, URL, and email
  • Verification status (verified or pending)
  • Date created
  • Number of badges associated with this issuer

Deleting an Issuer

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

Delete blocked — issuer has linked badges

An issuer can only be deleted if it has no badges and no awards. The dashboard pre-checks both before showing the confirmation dialog so you don't accidentally orphan public verification pages. To delete a busy issuer, first delete all of its awards, then its badges, then the issuer itself.

badges.ninja Documentation