Configure a belt system without assuming eligibility changes.
Use Belt Systems to edit the visible rank structure for a program. Current source keeps these settings separate from the rank eligibility store, so changing a belt or threshold here is not verified to change the Promotions queue.
Access and dependencies
- Open GymCore Admin > GymCore Settings > Belt Systems with
gymcore_manage_settings, or the administrator fallbackmanage_options. - Confirm the program taxonomy and the organization’s approved rank policy before editing.
- Export or record the current belt-system values from this screen before a broad change. Do not restore an entire site merely to reverse one threshold.
- Rank data is member progress information. Limit edits and exports to authorized staff.
Review the defaults and stored values
GymCore’s Foundations settings default to enabled, with these initial minimums:
- Phase 1 classes:
10, minimum1 - Coach rolls:
2, minimum1 - Total classes:
25, minimum1
These are settings-layer values. Do not state that they are the active promotion formula until an eligible-member result proves the eligibility engine consumes them.
Change one system deliberately
- Open GymCore Admin > GymCore Settings > Belt Systems.
- Select the intended program or belt system.
- Record the current rank order, labels, colors, and threshold values displayed by the installed screen.
- Change only the approved values. Keep every numeric minimum within the control’s displayed range.
- Select Save changes.
Expected: WordPress reports that settings were saved and the same belt-system values remain after reload. This confirms configuration storage only.
Test the eligibility boundary
- Identify controlled member records just below, at, and above the changed threshold using accurate attendance and rank history.
- Open the Promotions view and compare their eligibility results with the expected policy.
Expected: Record the actual result. Current source separates the visible settings/custom belt systems from the eligibility store; if the queue does not change, stop and treat the setting as non-authoritative for promotions.
- Check member-facing rank labels or progress output for the same controlled records.
Expected: Presentation and eligibility may differ. Do not launch the new policy until both have an approved, source-backed outcome.
Reverse or recover
Restore the recorded prior values and select Save changes. Recheck both presentation and Promotions; reverting the settings does not necessarily reverse rank-history events or promotions already recorded. Correct those in their own source through the approved rank-data process.
Verify in the source systems
Confirm saved structure in Belt Systems, eligibility in the Promotions queue, and actual member rank in rank history or the student profile. A belt-system settings screen cannot by itself establish which thresholds the eligibility engine enforced.
Need help?
Describe one problem and the installed versions. Never send passwords, license keys, API keys, payment details, or member records.