Ceremonies and promotions

Ceremonies and promotions

Belt and stripe promotions are first-class on CombatScore. Schedule a ceremony, pick recipients, and the platform handles record-keeping for everyone involved — including a nice shareable card for the athlete.

Quick promotions

For a single athlete, you don't need a ceremony.

Coach → Athletes → [Athlete] → Promote. Pick the new rank, optional notes, and date. Saves to their belt timeline immediately.

Use this when you award stripes between classes or promote informally.

Ceremonies

For batch promotions (test day, end-of-cycle), create a ceremony.

Coach → Ceremonies → New ceremony.

• Title. "Spring 2026 BJJ promotion ceremony" etc.
• Date.
• Disciplines. Which disciplines this ceremony covers (auto-filters who can be promoted).
• Notes. Optional context shown on each recipient's timeline.

Save → you'll see the empty ceremony page.

Adding recipients

On the ceremony page, Add recipient → pick an athlete + the new rank + (optional) per-athlete notes.

Save the recipient. You can edit or remove until you finalize the ceremony.

Finalizing

Finalize ceremony is the action that:

1. Writes a promotion record to every recipient's belt timeline.
2. Notifies every recipient (push + email).
3. Generates a shareable promotion card per recipient (background, accent color, your gym logo).
4. Bumps each recipient's combat score by the promotion bonus.
5. Locks the ceremony so it can't be edited (you can still re-open if needed; lock is just to prevent accidental drift).

Finalization is irreversible without a manual revert — that's intentional. Once a promotion is announced, undoing it should be a deliberate choice.

The shareable card

Every recipient gets a 1080×1080 social-media-ready card with:

• Their name + new rank
• Date
• Your gym name + logo
• Optional quote (you can write one per recipient or use a default)

Card is downloadable from the athlete's profile. They share it; the URL drives traffic back to your gym's public site.

Reverting a promotion

Rare, but happens (recorded the wrong belt, athlete declined, etc.).

Coach → Athletes → [Athlete] → Belt timeline → [Promotion] → Revert.

The promotion is reversed and the athlete is notified. The audit log keeps a record of the revert with timestamp + reason.

Athletes promoting themselves

They can't. Self-promotions are not a feature — only a coach with promote_athletes permission can issue a rank change. Athletes can manually add "claimed rank" entries to their bio for ranks earned at past gyms, but those are clearly labeled as unverified.

Multi-discipline

If an athlete trains BJJ + striking, each discipline has its own belt timeline. A BJJ promotion doesn't touch striking and vice versa. The ceremony's "disciplines" field controls what's eligible.