Astral gives you fine-grained control over who can see your training data. You can choose to share openly with your coach and group, keep certain metrics private, or lock down your profile entirely. Your privacy settings apply wherever your profile appears in Astral — on leaderboards, activity feeds, and when your coach views your data.
Privacy settings reference
Activity sharing (master switch)
share_activity_in_profile — This is the master switch for all activity sharing. When this is turned off, none of your activities are visible to anyone else, regardless of the other settings below. When it’s on, the individual settings below take effect.
Audience controls
These settings let you choose which groups of people can see your activities when the master switch is on.
| Setting | What it controls | Default |
|---|
share_activity_with_group | Members of your training group can see your activities | On |
share_activity_with_coach | Your assigned coach can see your activities | On |
share_activity_with_public | Anyone on Astral can see your activities | Off |
Public activity sharing is off by default. You must explicitly turn it on if you want your activities visible to all Astral users.
Data detail controls
These settings control which specific data fields are included when someone views your activities or profile.
| Setting | What it controls | Default |
|---|
share_pace_data | Your average pace is shown on activities | On |
share_activity_map | The GPS route map is shown on activities | On |
share_race_history | Your race results are visible on your profile | On |
share_pb | Your personal bests (PBs) are visible on your profile | On |
share_race_goal | Your target race and goal time are visible | On |
share_profile_info | Your profile photo and bio are visible | On |
share_training_data | Detailed training metrics like heart rate and elevation are shared | On |
Coach access
share_with_coach — Grants your coach full access to your training data, including metrics that would otherwise be restricted by your other settings. Your coach needs this data to provide effective coaching feedback and AI-generated training plans. If you turn this off, your coach’s view of your data will be limited.
Leaderboards
paticipate_leaderboard — Controls whether you appear on group or organization leaderboards. Turn this off if you’d rather train without your results being compared against others.
Update your privacy settings
You can update any privacy setting through the app or via the API.
In the app: Go to Settings → Privacy and toggle the settings you want to change.
Via the API: Send a PUT request to your user profile with a privacy object containing only the fields you want to change:
PUT /api/v1/users/{user_id}
Authorization: Bearer <your_token>
Content-Type: application/json
{
"privacy": {
"share_activity_with_public": false,
"share_activity_map": false,
"paticipate_leaderboard": false
}
}
How privacy is enforced
Astral enforces your privacy settings every time someone accesses your profile or activities, including through the app, the API, and any integrations your organization uses. The access context also matters: for example, leaderboard views apply stricter rules than a direct coach view, even if your coach normally has full access.
If you’re an athlete in a coaching organization, your coach and group members will typically have access to your activities by default. You can restrict this using share_activity_with_coach and share_activity_with_group — but keep in mind this will limit the quality of coaching feedback you receive.
