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
backgroundColorstringformat COLOR_HEX

Badge background color in hexadecimal RGB format.


createdDatestringRead-onlyformat date-time

Date and time the badge was created.


descriptionstringmaxLength 1500

Badge description explaining its purpose or criteria for earning it.


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.


idstringRead-onlyformat GUID

Badge ID.


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.


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.


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.


textColorstringformat COLOR_HEX

Badge text color in hexadecimal RGB format.


titlestringminLength 1maxLength 50

Badge title displayed on the member's profile.


updatedDatestringRead-onlyformat date-time

Date and time the badge was last updated.

Did this help?