Managing Badges

Managing Badges#

Synchronizing Badge Templates#

Badge templates (Credly) and groups (Accredible) are created on the provider’s side and then pulled into the Credentials service through a sync action in the admin panel.

For Credly:

  1. Select one or more organizations on the “Credly Organizations” list page.

  2. Run the Sync organization badge templates action.

Only badge templates with active state on Credly are pulled. See Credly Configuration for details.

For Accredible:

  1. Select one or more configurations on the “Accredible API Configs” list page.

  2. Run the Sync groups action.

See Accredible Configuration for details.

Note

Synchronized templates and groups are created inactive by default. Configure requirements and activate them before they take effect. See Activation.

Badge Progress#

Current badge progress is visible in the “Badge progress records” section of the Credentials admin panel.

Badge templates can have more than one requirement, so there can be partially completed badges. See Badges Processing for details on how progress is tracked.

Awarded Credentials#

Earned badges are listed in the provider-specific section of the admin panel.

Note

Each badge is an extended version of a user credential record.

Once badge progress is complete (all requirements are fulfilled), the system awards the badge. See Badges Processing for the full awarding pipeline.

The system:

  1. Creates an internal user credential record for the learner.

  2. Emits a public signal about the badge award.

  3. Sends an API request to the badge provider to issue the badge externally.

Issued Badges#

After a badge is awarded internally, the system sends an API request to the badge provider to issue the badge on their platform.

On successful issuing, the badge record in the admin panel is updated with:

  1. external UUID - the identifier assigned by the provider.

  2. external state - the badge status on the provider’s side (e.g. accepted).

The issued badge then appears in the provider’s dashboard and is visible to the learner.

Badge Template Withdrawal#

Deactivate a badge template by unchecking the is active checkbox on its edit page. See Badging Configuration for activation details.

Inactive badge templates are ignored during processing.

See also

Badging Configuration

Configure badge templates, requirements, and data rules.

Badging Settings

Feature switches and integration settings.

Badges Processing

How incoming events are processed and badges are awarded.

Contents