Timeslot swaps

The timeslot swap feature lets members exchange their assigned weekly session for a different occurrence when they cannot make it. Instead of simply missing class, the member declines their slot in the mobile app, receives a swap credit, and uses it to attend an alternative session within a set number of days.

A swap is always one-time -- it does not change the member's permanent assignment. If a member wants to change their regular schedule permanently, an admin must update their time slot assignment.

How it works

1. Member sees an upcoming class they cannot attend. In the mobile app, they decline the session instead of just not showing up.
2. A swap credit is issued automatically, valid for the number of days configured in Settings.
3. The member browses available sessions and picks an alternative occurrence to attend.
4. The credit is consumed and the member's attendance intention for the new session is confirmed.

If the member does not use the credit before it expires, it is automatically marked as expired.

Enabling timeslot swaps

Navigate to Settings > Check-in and enable Timeslot swaps.

The following options are available:

• Enabled -- Master toggle for the feature. Off by default.
• Allow cross-class swaps -- When on, a credit can be used in any eligible class, not just the one the member originally declined. When off, the credit can only be applied to a different occurrence of the same class.
• Enforce capacity -- When on, a member cannot use a swap credit to join a session that is already at its maximum participant limit.
• Credit expiry (days) -- How many days a swap credit remains valid after it is issued. Default: 7 days.
• Max credits per month -- Maximum number of swap credits a member can receive in a calendar month. Set to 0 for unlimited.

Per-class override

By default, all classes with assigned time slots respect the global swap setting. You can override this per class in the class settings:

• Inherit global setting -- Follows the global enabled/disabled toggle (default).
• Enable for this class -- Swaps always allowed for this class, regardless of the global setting.
• Disable for this class -- Swaps never allowed for this class, regardless of the global setting.

Member experience

Everything happens in the mobile app -- there is no swap interface in the admin panel.

1. The member opens their schedule and taps on a future assigned session.
2. They tap Decline to indicate they cannot attend.
3. The app shows their swap credit with the expiry date.
4. The member taps Find alternative to browse eligible sessions.
5. They pick a session and confirm -- the credit is applied and their spot is reserved.

The mobile app shows a visual indicator on sessions the member attended via a swap, distinguishing them from regular assigned sessions.

Viewing swap history

Swap credits are recorded in the member's activity log on their profile page. You can see when a credit was issued, when it was used, and which session the member swapped into.

Credit lifecycle

Expired credits are processed automatically by a scheduled background task.