Skip to main content
An organization in Astral is the home for a coaching club, running team, or training group. Every training plan, workout library, group activity feed, and member roster is scoped to an organization. If you’re a coach, your organization is where all your work happens. If you’re an athlete, joining an organization connects you to a coach and gives you access to a shared training environment.

​
What an organization contains

An organization groups together:
  • A Head Coach — the account that created the organization and has full administrative control
  • Assistant Coaches — coaches added by the Head Coach who can manage athletes assigned to them
  • Members (athletes) — the runners following training plans within the organization
  • A workout library — workouts created by coaches, shared within the organization
  • Training plan templates — plans that coaches can assign to individual athletes or entire groups
  • Groups — optional sub-divisions within the organization (e.g., by pace, event, or training phase)

​
How athletes join

Athletes join an organization by invitation from a coach. When a coach adds an athlete’s email address via the coach console (Members → Add Member), the athlete receives an invitation. If the athlete already has an Astral account, they are added to the organization immediately. If they don’t have an account yet, the invitation email guides them through signup, and their new account is automatically linked to the organization. Once an athlete is a member, their profile shows an org_id linking them to the organization. They can only be a member of one organization at a time.
Athletes do not need to know your organization ID or any invite code. Adding their email through the coach console is all that is required.

​
Coaches and their athletes

​
Head Coach

Every organization has exactly one Head Coach. The Head Coach can:
  • Add and remove athletes from the organization
  • Add and remove assistant coaches
  • Assign individual athletes to specific assistant coaches — so each coach has a dedicated roster
  • View all members and all coach-athlete assignments in the organization
  • Create and assign training plans to any member

​
Assistant Coaches

The Head Coach adds assistant coaches via Settings → Coaches → Add Coach. Once added, an assistant coach’s account is linked to the organization and their membership_roles array is updated to include "coach". Assistant coaches can:
  • View all members in the organization (full member list)
  • Create workouts and training plan templates
  • Assign plans to athletes on their roster
  • View and comment on the activities of athletes assigned to them
Only the Head Coach can assign which athletes each assistant coach manages. An assistant coach cannot add or remove other coaches.

​
Coach-to-athlete assignments

Assignments connect a specific assistant coach to a specific athlete. When an assignment exists:
  • The athlete appears on that coach’s roster in the console
  • The coach can view that athlete’s activities (subject to the athlete’s privacy settings)
  • The coach can assign training plans and leave feedback on workouts
A single athlete can only be assigned to one coach at a time. The Head Coach can reassign athletes between coaches at any time.

​
Groups

Within an organization, coaches can create groups to subdivide their athletes. Groups are useful when you have runners training for different race distances, at different paces, or on different schedules. Groups affect:
  • Activity sharing — athletes can choose to share their activities with their training group
  • Plan assignment — you can assign a training plan to an entire group at once rather than athlete by athlete
  • Leaderboard — group leaderboards show relative performance within the same training cohort
Groups are the recommended way to manage organizations with more than 20 athletes. Filtering the member list by group makes it much faster to find the athletes you’re looking for.

​
Organization structure at a glance

Organization
├── Head Coach (1)
├── Assistant Coaches (0 or more)
│   └── Assigned Athletes (per coach)
├── Members / Athletes (all)
│   └── Groups (optional sub-divisions)
├── Workout Library
└── Training Plan Templates

​
Visibility rules

Coaches see everything within their organization. Athletes see only their own data, their training plan, and — depending on their privacy settings — the activity feed of their group. Athletes cannot see other athletes’ private notes or coach assignments.
Who can see whatAthleteAssistant CoachHead Coach
Own profile and activitiesYesYesYes
Other athletes’ profilesNo (privacy-filtered)Yes (full)Yes (full)
Coach private notesNoOwn notes onlyAll notes
Coach-to-athlete assignmentsNoOwn assignmentsAll assignments
Organization workout libraryYes (public workouts)Yes (all)Yes (all)