Groups

Groups are at the core of SwapSanity, allowing you to organize your team and manage shifts efficiently. This guide explains how to create and manage your groups.

Joining a Group

You can join groups even if you already belong to others.

  • First launch (no groups): Home shows Join a Group and Create a New Group.
  • Already in groups: Profile → Join another group → Join a Group (Code / QR / Link).

Admins share a 6-character code or a QR/link like https://swapsanity.com/join/CODE (valid 24 hours). After you request to join, an admin must approve (unless your email is pre-approved).

See Joining groups (code, QR, link) for camera vs deep link vs in-app scan details.

Creating a New Group

Any user can create a new group and become its first administrator.

  1. Navigate to your profile by tapping the profile icon in the top-right corner of the home screen.
  2. Scroll to Create a New Group (below Join another group).
  3. Enter a name for your new group.
  4. Tap the “Create Group” button.

The new group will now appear in your groups list; you are owner/admin.

Managing Your Group

As an administrator, you have several tools to manage your group and its members from the Manage Group screen.

Accessing the Manage Group Screen

You can get to the management screen for a specific group in two ways:

  • From your Profile: Go to your profile screen, find the group in the “Groups You Administer” list, and tap the “Manage” button.
  • From the Admin Panel: Go to the Admin Panel, select the group you wish to manage from the dropdown menu, and tap the “Manage Group Members” button.

Adding Members

You can add any user who has a SwapSanity account to your group.

  1. On the “Manage Group” screen, find the “Add Member by Email” section.
  2. Enter the email address of the user you want to add.
  3. Tap the “Add Member” button.

The user will be added to your group and will be able to see the group’s shifts and trade requests.

Group locations

Admins define named places under Admin → Manage Locations (search on the map, drag the pin, set an autostart circle, optional share/event fence).

  • Public places are visible to members of the group.
  • Private (only me) saves to your personal places only — not on the group, and not visible to other members or admins.
  • Autostart uses a circle only (battery-friendly geofencing). A polygon is only for live-share / event privacy (leaving stops sharing)—it never starts GPS.
  • Members can open Profile → Browse group places to copy a public place into personal places or suggest it to admins; suggestions are not official until an admin accepts them (Manage Locations shows a pending queue).

Details: Administrator Features — Manage Locations.

The Member List

The main part of this screen is the list of all current group members.

  • Filtering: Above the list is a search bar that allows you to filter the list of members by name or email to quickly find a specific person.
  • Member Details: Each member is shown on a card with their name and email address.

For each member in the list, you have several actions available:

Removing Members

If a user should no longer be part of your group, you can remove them by tapping the Remove icon (a trash can) on their card.

  • A confirmation dialog will appear. Tap “Remove” to confirm.
  • When you remove a member, any of their future shifts within that group will become unassigned.
  • Important: Removing a member also adds them to the group’s “blocked” list, preventing them from re-joining unless they are unblocked from their user profile.

Managing Administrators

You can grant or revoke administrator privileges for any member. Admins have the same management capabilities as you.

  • To make a member an admin: Find the member in the list and toggle the “Admin” switch on their card to the “on” position.
  • To revoke admin rights: Toggle the “Admin” switch to the “off” position.
  • You cannot remove the last administrator of a group.

Communicating with Members

You can contact individual members directly from their card in the list:

  • Message User (Chat Icon): Opens a screen to send an in-app message to that specific user.
  • Text User (SMS Icon): Opens your device’s default texting app to send an SMS message to the user’s registered phone number.

Batch export static QRs

Admins can Batch Export Static QRs to print field ID cards (leads, guardians, kids). These are check-in identity QRs, not join-invite QRs.

Export beacons (CSV)

Below static QR export, Export beacons (CSV) downloads programming data for kid iBeacon tags (group UUID, major, minor, tracker id). Use when flashing Feasycom-style tags. CLI: swapsanity_cli export-beacons --group-id ….

Time Clock Reports

At the top of the “Manage Group” screen, there is a View Reports button. This will take you to the Time Clock Summary Screen, where you can generate and view payroll or time-tracking reports for all members of the group.