The Badges V2 API allows you to create and manage badges on a site. Badges are visible labels displayed on site member profiles that encourage member participation by rewarding milestones and optionally grant them special permissions.
With Badges V2 API you can:
- Create badges with titles, colors, descriptions, and icons.
- Update badge properties.
- Retrieve badges with filtering and sorting.
- Manage badge display order to control how they appear to members.
The Badges V2 API manages badge definitions only. To assign badges to members, use the Badge Assignments API.
For an overview of badges, see Creating and Managing Member Badges.
It’s important to note the following points before starting to code:
- The site must have Wix Members Area installed.
- Badges can optionally grant site members special permissions to access specific members-only pages. The actual permissions configuration is done by site owners in the site dashboard, not through the API. Site members receive the permissions once a permission-granting badge is assigned to them.
- Deleting a badge automatically removes it from all members who currently have it assigned.
Set up a member tier system
- Badge: A visible label displayed on a site member's profile, consisting of a title, color, and optional icon.