Badge Object


A badge is a visible label displayed on a site member's profile.

Site owners can create badges to categorize members and optionally grant them special permissions to access specific pages.

Badges are managed separately from their assignment to members. To assign badges to members, use the Badge Assignments API.

For more information, see Creating and Managing Member Badges.

Properties
idstringRead-onlyformat GUID

Badge ID.


revisionstringRead-onlyformat int64

Revision number, which increments by 1 each time the badge is updated. To prevent conflicting changes, the current revision must be passed when updating the badge.


titlestringminLength 1maxLength 50

Badge title displayed on the member's profile.


descriptionstringmaxLength 1500

Badge description explaining its purpose or criteria for earning it.


backgroundColorstringformat COLOR_HEX

Badge background color in hexadecimal RGB format.


textColorstringformat COLOR_HEX

Badge text color in hexadecimal RGB format.


iconIcon

Badge icon image.

Any image format is accepted with automatic conversion and resizing handled by the system. SVG format is recommended as it is resolution independent and looks great at any scale.


permissionsEnabledboolean

Whether the badge grants special permissions to access specific members-only pages.

When true, members with this badge receive special permissions. Site owners can configure these permissions in the site dashboard. For more information, see Creating and Managing Member Badges.


slugstringRead-onlyminLength 1maxLength 255

URL-friendly slug for the badge, automatically generated from the title.

Generated by converting the title to lowercase, replacing spaces with hyphens, and removing special characters.


createdDatestringRead-onlyformat date-time

Date and time the badge was created.


updatedDatestringRead-onlyformat date-time

Date and time the badge was last updated.

Did this help?