# DistantRace Documentation URL: /en/ # DistantRace Documentation Welcome to the DistantRace documentation. Use the navigation to browse all topics, or start with one of the guides below. ## For participants - [Joining events](joining-events/index.md) — start here - [Mobile app](mobile-app/index.md) — steps, workouts, and events on iOS and Android - [Create an account](joining-events/create-an-account.md) - [Participate in a challenge](joining-events/participate-in-a-challenge.md) - [Supported apps](connections-with-apps/supported-apps.md) - [Data synchronization problems](connections-with-apps/data-synchronization-problems/the-most-common-reasons-for-data-synchronization-issues.md) ## For organizers - [Running events](running-events/index.md) — start here - [Event types overview](running-events/event-types-overview.md) - [Create a step challenge](running-events/create-a-step-challenge.md) - [Challenge settings walkthrough](running-events/challenge-settings-walkthrough.md) - [Race certificate creation](results/race-certificate-creation.md) --- # Can't find my favorite sports app URL: /en/connections-with-apps/cant-find-my-favorite-sports-app/ # Can't find my favorite sports app DistantRace connects to many sports apps via official OAuth — see the full table in [Supported apps](supported-apps.md). ## Apps we integrate today Including Garmin, Polar, Suunto, Fitbit, Wahoo, MapMyRun/Walk/Ride, Decathlon Coach, Withings, and step sources (Apple Health, Google Fit, Health Connect, Samsung Health). ## No longer supported - **Adidas Running (Runtastic)** — integration removed. Use another [supported app](supported-apps.md) or [manual upload](../joining-events/managing-your-activities.md). - **Strava (direct sync)** — not in [Supported apps](supported-apps.md); direct activity sync is unavailable. See [Strava and DistantRace connection](strava-and-distantrace-connection.md) for workarounds (manual FIT/GPX upload, Suunto, or Wahoo). ## Apps without official integration Some brands do not offer third-party API access. Examples that **currently cannot** connect directly: - Nike Run Club - Coros (limited) - Amazfit / Zepp (no public API) - Runkeeper (deprecated API) For **Huawei Health** sports GPS, use [manual file upload](../joining-events/managing-your-activities.md) or a watch that syncs to a supported app. Steps may work via [Huawei step sync](how-to-sync-steps-with-a-huawei-watch.md). ## Workarounds 1. **Record in a supported app** that your watch already syncs to (e.g. Garmin Connect, Suunto, Polar Flow) 2. **Upload GPX/FIT files** manually — [Managing your activities](../joining-events/managing-your-activities.md) 3. **Export from your app** — [Extracting activity files](../extracting-activity-files/index.md) ## Request an integration Contact support@distantrace.com with your app name — user demand helps prioritization. ## Related - [The most common reasons for data synchronization issues](data-synchronization-problems/the-most-common-reasons-for-data-synchronization-issues.md) --- # Connect with Adidas Running (Runtastic) URL: /en/connections-with-apps/connect-with-adidas-running-runtastic/ # Connect with Adidas Running (Runtastic) ::: warning No longer available Adidas Running (Runtastic) integration was removed from DistantRace. Choose another app from [Supported apps](supported-apps.md), or [upload activities manually](../joining-events/managing-your-activities.md). ::: The instructions below are kept for reference only. If you use the Adidas Running (Runtastic) app on a daily basis, then you have the opportunity to connect this app to distantrace.com. Adidas offers to synchronize sports activities. [![](/static/img/connections-with-apps/connect-with-adidas-running-runtastic/image-1712068597748.png)](https://apps.apple.com/lv/app/adidas-running-walk-run-app/id336599882) [![](/static/img/connections-with-apps/connect-with-adidas-running-runtastic/image-1712068604036.png)](https://play.google.com/store/apps/details?id=com.runtastic.android) 1. **Create accounts** for both distantrace.com and Adidas Running (Runtastic) (you may already have an account there). 2. **Add Adidas Running (Runtastic) to distantrace.com** There is a "[Connections](https://distantrace.com/en/accounts/social/)" section in your distantrace.com account. Find Adidas Running (Runtastic) and click "Connect". 3. **Authorize data retrieval from Adidas Running (Runtastic)** You will be redirected to the Adidas Running (Runtastic) homepage. Log in and authorize data access. 4. **Synchronize Adidas Running (Runtastic) sports activities** When the connection is successfully established, your sports activities from Adidas Running will automatically be uploaded to distantrace.com. The start time, activity time, distance, route, and other metrics will be uploaded for each sports activity. 1. **View uploaded activities** All uploaded activities can be viewed in the "[Activities](https://distantrace.com/en/accounts/my_workouts/)" section of your profile. #### How to record activities with a mobile phone? We have prepared instructions: [How to record sports activity using the Adidas Running app](../recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-adidas-running-app.md) #### Possible connection issues A common problem that activities do not appear is different accounts. One Adidas Running account is connected to the phone where activities are created, but another account is connected to distantrace.com. You can identify the Adidas Running account ID connected to DistantRace in the "[Connections](https://distantrace.com/en/accounts/social/)" attached to the Adidas Running account. This ID can help determine if you have multiple Adidas Running accounts. Here's how to verify your Adidas Running account: 1. **Compare Adidas Running account ID:** - [Open the Runtastic homepage](https://www.runtastic.com/) with a web browser. - [Go to account settings](https://www.runtastic.com/en/users/K6B7TVAGS5S55JX8/settings/account-and-data). - Check the user ID in the URL and compare it with the one shown in your DistantRace "Connections" with the attached Adidas Running account. - If the user IDs differ, it means that another Adidas Running account is attached to DistantRace. - While in the Runtastic settings view, also check the email associated with your Adidas Running account. ![](/static/img/connections-with-apps/connect-with-adidas-running-runtastic/image-1712039120001.png) 1. **Compare email addresses:** - Open your profile on the mobile app and then click on the Settings icon. - In the "Edit profile" section, you can find your email address. - Compare this email address with the one seen in the web browser. - If the email addresses are not the same, it indicates that you may be using several Adidas Running accounts. ![](/static/img/connections-with-apps/connect-with-adidas-running-runtastic/image-1712039292837.png) 1. **Solve the multiple accounts issue:** - To solve this issue, first log out of your Runtastic account in the web browser. - Disconnect your Adidas Running account from your DistantRace profile (you can do this in the "[Connections](https://distantrace.com/en/accounts/social/)" section). - Reconnect Adidas Running account with DistantRace using the same email address listed in the mobile app. --- # Connect with Decathlon Coach URL: /en/connections-with-apps/connect-with-decathlon-coach/ # Connect with Decathlon Coach If you use Decathlon Coach daily, you have the opportunity to connect Decathlon Coach to distantrace.com. [![](/static/img/connections-with-apps/connect-with-decathlon-coach/image-1712068597748.png)](https://apps.apple.com/lv/app/decathlon-coach-sport-running/id495106186) [![](/static/img/connections-with-apps/connect-with-decathlon-coach/image-1712068604036.png)](https://play.google.com/store/apps/details?id=com.geonaute.geonaute) 1. **Create accounts** on both distantrace.com and Decathlon Coach (you may already have an account there). 2. **Connect Decathlon Coach to distantrace.com** In your distantrace.com account, there is a section "[Connections](https://distantrace.com/en/accounts/social/)". Find Decathlon Coach and click "Connect". 3. **Authorize data reception from Decathlon Coach** You will be redirected to the Decathlon Coach homepage. Log in and authorize data access. ![](/static/img/connections-with-apps/connect-with-decathlon-coach/image-1711994787079.png) 1. **Synchronize Decathlon Coach sports activities** Once the connection is successfully created, your sports activities from Decathlon Coach will automatically be loaded into distantrace.com. The start time, activity time, distance, route and other metrics will be loaded for each sports activity. 1. **View loaded activities** All loaded activities can be viewed in the profile section ["Activities"](https://distantrace.com/en/accounts/my_workouts/). #### How to record activities with a mobile phone? We have prepared instructions: [How to record sports activities using the Decathlon Coach app](../recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-decathlon-coach-app.md) #### Potential connection issues The most common issue is that activities do not show up due to multiple accounts. One Decathlon Coach account is connected to the phone where activities are created, but another account is connected to distantrace.com. Decathlon provides limited data about your account, and only your date of birth is available. Unfortunately, there is no direct way to check which email is associated with your Decathlon Coach app in their mobile app and website. However, there are some ways to determine if you have multiple accounts. 1. **Compare birth data:**\ Start by checking your [profile information](https://www.decathloncoach.com/en-lv/portal/completion-profile-update) by opening the web version of Decathlon Coach in a web browser. Compare the date of birth seen there with the date displayed in the "Connections" section under Decathlon Coach. Please note that the date of birth that was registered at the time of connection is shown. ![](/static/img/connections-with-apps/connect-with-decathlon-coach/image-1711995254606.png) 1. **Check for discrepancies in sports activities:**\ Then check your workouts in a [web browser](https://www.decathloncoach.com/en-lv/portal/activities) and compare them with the app. If you notice differences, you may have multiple accounts, or sports activities are not synchronized with the server. Sports activities that are not on the server will not be synchronized with DistantRace. ![](/static/img/connections-with-apps/connect-with-decathlon-coach/image-1711995397208.png) 1. **Disconnect and reconnect:**\ If you suspect that you may have multiple accounts, it is recommended to disconnect your Decathlon account from DistantRace. Additionally, log out of the Decathlon Coach app and web browser on your mobile device. To recreate the connection, use the same email address that you see in the mobile app and re-add Decathlon using the "[Connections](https://distantrace.com/en/accounts/social/)" view. We recommend using a private browser window to prevent potential conflicts with the login data saved in cookies. This process will help ensure that the correct Decathlon account is connected to DistantRace for accurate data synchronization. ![](/static/img/connections-with-apps/connect-with-decathlon-coach/image-1711995564016.png) --- # Connect with Fitbit URL: /en/connections-with-apps/connect-with-fitbit/ # Connect with Fitbit If you use Fitbit devices daily, then you have the opportunity to connect Fitbit to distantrace.com. Fitbit offers synchronization of both daily steps and sports activities. [![](/static/img/connections-with-apps/connect-with-fitbit/image-1712068597748.png)](https://apps.apple.com/lv/app/fitbit-health-fitness/id462638897) [![](/static/img/connections-with-apps/connect-with-fitbit/image-1712068604036.png)](https://play.google.com/store/apps/details?id=com.fitbit.FitbitMobile) 1. **Create accounts** on both distantrace.com and Fitbit (you may already have an account there). 2. **Add Fitbit to distantrace.com** Your distantrace.com account has a section "[Connections](https://distantrace.com/en/accounts/social/)". Find Fitbit and click "Connect". 3. **Authorize data receipt from Fitbit** You will be redirected to the Fitbit webpage. Log in and authorize data access. 4. **Synchronize Fitbit sports activities** Once the connection is successfully established, your sports activities from Fitbit will automatically be uploaded to distantrace.com. The uploaded sports activity will include the start time, activity duration, distance, route, and other metrics. 1. **Synchronize Daily Steps** After adding Fitbit, if you have allowed DistantRace to receive daily steps, it's possible to set Fitbit as the "provider" of daily steps. This can be done in 2 ways: - by setting up the [distantrace.com app](https://distantrace.com/app) and selecting Fitbit as the step provider in settings. ![Daily steps in the app](/static/img/connections-with-apps/connect-with-fitbit/img-6526-phone.png) - on the distantrace.com website by opening the ["daily steps"](https://distantrace.com/en/accounts/daily_stats/) section. ![Daily steps on distantrace.com](/static/img/connections-with-apps/connect-with-fitbit/screenshot-2024-04-01-at-14-53-48.png) 1. **View uploaded activities** All uploaded activities can be viewed in the profile section ["Activities"](https://distantrace.com/en/accounts/my_workouts/). #### How to record activities with a mobile phone? We have prepared instructions: [How to record a sports activity using the Fitbit app](../recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-fitbit-app.md) #### Possible Connection Issues The most common issue for activities not appearing is different accounts. One Fitbit account is connected on the phone, where activities are created, but another account is connected to distantrace.com. Let's go through all the steps to resolve the issues. DistantRace receives specific details from your Fitbit account, such as your Fitbit user ID, first name, and last name. These details are crucial for verifying if the correct Fitbit account is connected. 1. **Log in to the Fitbit dashboard:**\ Open the [Fitbit website](https://www.fitbit.com/login/transferpage) in a browser and log in. 2. **Compare user ID:**\ Once logged in, your user ID appears in the browser address. Compare this user ID with what is shown in DistantRace under "Connections". If they don't match, a different account is connected to DistantRace. ![Fitbit User ID](/static/img/connections-with-apps/connect-with-fitbit/image-1711979326968.png) 1. **Compare profile information:**\ Go to ["Personal Info"](https://www.fitbit.com/settings/profile). Here you'll find the email associated with your Fitbit account, and your name and surname. Compare this information with what is shown in DistantRace. The information should match what was set at the time of connection. ![Fitbit Profile Information](/static/img/connections-with-apps/connect-with-fitbit/image-1711979555052.png) 1. **View added applications:** In the [Applications](https://www.fitbit.com/settings/applications) section, you can look for "DistantRace" in this list. If found, then this account is connected to DistantRace (hopefully to the correct DistantRace account). If not found, it means Fitbit is not connected to DistantRace. Ensure that the necessary permissions are granted for DistantRace to access data; if not, press "Revoke Access" and re-add Fitbit to DistantRace through the "[Connections](https://distantrace.com/en/accounts/social/)" section. ![Fitbit Applications](/static/img/connections-with-apps/connect-with-fitbit/image-1711979555052.png) 1. **Check if activities are displayed:**\ In your Fitbit account, under the ["Activities"](https://www.fitbit.com/activities) section, you can view all activities done with Fitbit. If the activities don't match those displayed on the phone, it could mean you have multiple Fitbit accounts. Only activities shown here will be sent to DistantRace. 2. **Check your email in the Fitbit mobile app:**\ In your mobile app, go to "account settings" then "Change Email". Here you have the opportunity to compare the email with what was shown in the previous steps. ![Fitbit Email](/static/img/connections-with-apps/connect-with-fitbit/udjr35ajm5yizc5ggdiebxuvd.png) 1. **Disconnect the connection:**\ If you find that the Fitbit account is connected to the wrong DistantRace account, then disconnect it by pressing "Revoke Access". This will delete the connection and allow connecting to the correct DistantRace account. #### Manually Upload Activities It's possible to export and upload an activity file from Fitbit. [More info here.](../extracting-activity-files/fitbit-tcx-download.md) --- # Connect with Garmin Connect URL: /en/connections-with-apps/connect-with-garmin-connect/ # Connect with Garmin Connect If you use Garmin devices daily, you have the option to connect Garmin to distantrace.com. Garmin offers synchronization of both daily steps and sports activities. [![](/static/img/connections-with-apps/connect-with-garmin-connect/image-1712068597748.png)](https://apps.apple.com/lv/app/garmin-connect/id583446403) [![](/static/img/connections-with-apps/connect-with-garmin-connect/image-1712068604036.png)](https://play.google.com/store/apps/details?id=com.garmin.android.apps.connectmobile) 1. **Create accounts** on both distantrace.com and Garmin Connect (you might already have an account there). 2. **Add Garmin Connect to distantrace.com** Your distantrace.com account has a "[Connections](https://distantrace.com/en/accounts/social/)" section. Find Garmin Connect and click "Connect". 3. **Authorize data receipt from Garmin** You will be redirected to the Garmin Connect website. Log in and authorize data access. You will have 2 options to choose from: - "Activities" - check this if you want DistantRace to access your sports activity data. - "Daily Health Stats" - check this if you want DistantRace to access your daily step data. ![Garmin Connect Flow](/static/img/connections-with-apps/connect-with-garmin-connect/garmin-connect-flow.png) 1. **Synchronize Garmin sports activities** Once the connection is successfully established, your sports activities from Garmin will automatically be uploaded to distantrace.com. The uploaded sports activity will include start time, activity duration, distance, route, and other metrics. Note that we cannot receive activities conducted before the connection was established. If necessary, such an activity can be [manually exported from Garmin Connect](../extracting-activity-files/garmin-gpx-download.md) and uploaded as a file to distantrace.com. 1. **Synchronize Daily Steps** After adding Garmin, if allowed to receive daily steps, Garmin Connect can be set as the daily step "provider". This can be done in 2 ways: - by setting up the [distantrace.com app](https://distantrace.com/app) and selecting Garmin as the step provider in settings. ![Daily steps in the app](/static/img/connections-with-apps/connect-with-garmin-connect/img-6526-phone.png) - on the distantrace.com website by opening the ["daily steps"](https://distantrace.com/en/accounts/daily_stats/) section. ![Daily steps on distantrace.com](/static/img/connections-with-apps/connect-with-garmin-connect/screenshot-2024-04-01-at-14-53-48.png) To have daily steps reach DistantRace, open the Garmin Connect app every day and press the "refresh" button in the upper right corner. ![Refresh button on Garmin Connect](/static/img/connections-with-apps/connect-with-garmin-connect/image-1712060779426.png) 1. **View uploaded activities** All uploaded activities can be viewed in the profile section ["Activities"](https://distantrace.com/en/accounts/my_workouts/). #### Possible Connection Issues The most common issue for activities not appearing is different accounts. One Garmin account is connected on the phone, where activities are created, but another account is connected to distantrace.com. Let's go through all the steps to solve problems. Garmin does not show DistantRace any information about your Garmin account (email, name), so the only way to understand where the synchronization issue lies is through the Garmin Connect webpage. Here are the steps: 1. **Log in to Garmin Connect:**\ Open the [Garmin Connect website](https://connect.garmin.com/) in a browser and log in. 2. **Open account settings:**\ Once logged in, go to "account settings," usually found in the upper right corner. 3. **View account information:**\ Look for the ["Account Information"](https://connect.garmin.com/modern/settings/accountInformation) section. Here you will find all the information about your Garmin account. 4. **View added apps:** You'll see all added apps here. Look for "DistantRace" in this list. If found, then this account is connected to DistantRace (hopefully, to the correct DistantRace account). If not found, it means Garmin is not connected to distantrace. 5. **Check the granted permissions:** Ensure that all necessary rights are granted. "Activities", if you want us to receive sports activities. "Daily Health Stats", if you want us to receive daily steps. 6. **Check if activities are displayed:** In your Garmin account, under the ["Activities" section](https://connect.garmin.com/modern/activities) (or ["Steps" section](https://connect.garmin.com/modern/daily-summary/2023-09-05/steps)), ensure all activities are displayed. If an activity doesn't show here, it hasn't reached DistantRace. Make sure the activity successfully syncs from the Garmin watch/device and there's an internet connection to send the activity to the Garmin server. 7. **Ensure the email is correct:** Lastly, ensure that the email address displayed in your Garmin account on the computer matches the email displayed in the Garmin app on your mobile phone. In the mobile app, the email can be found here:\ Profile -> Edit -> scroll down to "Manage Garmin Account". 8. **Disconnect the connection:** If you find that the Garmin account is connected to the wrong DistantRace account, disconnect it by pressing "Disconnect". This will delete the connection and allow connecting to the correct DistantRace account. ![Garmin Connect Settings](/static/img/connections-with-apps/connect-with-garmin-connect/garmin-connect-settings.png) #### Manually Upload Activities It's possible to export and upload an activity file from Garmin Connect. [More info here.](../extracting-activity-files/garmin-gpx-download.md) --- # Connect with Health Mate (Withings) URL: /en/connections-with-apps/connect-with-health-mate-withings/ # Connect with Health Mate (Withings) If you use Withings devices daily, you have the opportunity to connect Withings with distantrace.com. Withings offers to synchronize both daily steps and sports activities. ``` 🔴 Note that Withings does not allow us to access GPS (your training route) data. This means that you will not be able to participate in challenges and virtual events where GPS data is mandatory. Below is a detailed guide on synchronizing workouts and daily steps with Health Mate (Withings): ``` [![](/static/img/connections-with-apps/connect-with-health-mate-withings/image-1712068597748.png)](https://apps.apple.com/lv/app/withings-health-mate/id542701020) [![](/static/img/connections-with-apps/connect-with-health-mate-withings/image-1712068604036.png)](https://play.google.com/store/apps/details?id=com.withings.wiscale2) 1. **Create accounts** on both distantrace.com and Health Mate (you may already have an account there). 2. **Connect Health Mate to distantrace.com** In your distantrace.com account, go to the "[Connections](https://distantrace.com/en/accounts/social/)" section. Find Health Mate and click "Connect". 3. **Authorize data reception from Health Mate** You will be redirected to the Health Mate homepage. Log in and authorize data access. 4. **Synchronize Health Mate sports activities** When the connection is successfully established, your sports activities from Health Mate will automatically be loaded onto distantrace.com. The start time, activity time, and distance of the sports activity will be uploaded. 5. **Synchronize Daily Steps** After adding Health Mate, if you choose to receive daily steps, you can set Health Mate as your daily step "giver". There are 2 ways to do this: - by installing the [distantrace.com app](https://distantrace.com/app) and selecting Health Mate as your step provider in the settings. ![Daily steps in the app](/static/img/connections-with-apps/connect-with-health-mate-withings/img-6526-phone.png) - by visiting the ["daily steps"](https://distantrace.com/en/accounts/daily_stats/) section on the distantrace.com homepage. ![Daily steps on distantrace.com](/static/img/connections-with-apps/connect-with-health-mate-withings/screenshot-2024-04-01-at-14-53-48.png) 6. **View Uploaded Activities** All uploaded activities can be viewed in the profile section under ["Activities"](https://distantrace.com/en/accounts/my_workouts/). #### How to record activities with a mobile phone? We have prepared instructions: [How to Record Sports Activity Using the Health Mate (Withings) App](../recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-health-mate-withings-app.md) #### Possible connection issues The most common problem with activities not appearing is different accounts. One Withings (Health Mate) account is connected to the phone where activities are created, but another account is connected to distantrace.com. But let's go through all the steps to troubleshoot. DistantRace can access your Withings (Health Mate) account ID, which can help determine the correct account connected to your DistantRace profile. To verify your Withings account, perform the following actions: 1. **Compare Withings User ID:** - Log in to [Health Mate](https://healthmate.withings.com/24918324/timeline) using a web browser. - On your homepage, you can look at the web address and find your User ID there. - Compare this User ID with the one you see under the DistantRace "[Connections](https://distantrace.com/en/accounts/social/)" next to the Withings connection. - If the User IDs differ, it means that another Withings (Health Mate) account has been connected. ![](/static/img/connections-with-apps/connect-with-health-mate-withings/image-1712038298207.png) 2. **Compare email addresses:** - Open your profile on the Withings web browser (look for the arrow icon in the upper right corner). - In the mobile app, open your profile by clicking on the settings icon in the upper right corner and selecting "Account and Security". - Check and compare the Withings account email addresses on the web and in the mobile app. - If you find that the email addresses differ, it means that you may have multiple Withings accounts. The one connected to DistantRace may not match the one you use in your mobile app. ![](/static/img/connections-with-apps/connect-with-health-mate-withings/image-1712038457173.png) ![](/static/img/connections-with-apps/connect-with-health-mate-withings/image-1712038541580.png) 3. **Solve the multiple accounts issue:** - To solve this problem, log out of your Withings account in the web browser. - [Disconnect the Withings account](https://distantrace.com/en/accounts/social/) from your DistantRace profile. - Reconnect your Withings account with DistantRace using the same email address indicated in the mobile app. - By taking these actions, you can ensure that the correct Withings account that you are using in your mobile app is connected to DistantRace, ensuring precise data synchronization. --- # Connect with Polar Flow URL: /en/connections-with-apps/connect-with-polar-flow/ # Connect with Polar Flow If you use Polar devices daily, then you have the opportunity to connect Polar Flow to distantrace.com. Polar Flow offers synchronization of both daily steps and sports activities. [![](/static/img/connections-with-apps/connect-with-polar-flow/image-1712068597748.png)](https://apps.apple.com/lv/app/polar-flow/id717172678) [![](/static/img/connections-with-apps/connect-with-polar-flow/image-1712068604036.png)](https://play.google.com/store/apps/details?id=fi.polar.polarflow) 1. **Create accounts** on both distantrace.com and Polar Flow (you might already have an account there). 2. **Add Polar Flow to distantrace.com** Your distantrace.com account has a section "[Connections](https://distantrace.com/en/accounts/social/)". Find Polar Flow and click "Connect". ![Polar Flow connection flow](/static/img/connections-with-apps/connect-with-polar-flow/polar-flow-flow.png) 1. **Authorize data receipt from Polar Flow** You will be redirected to the Polar Flow website. Log in and authorize data access. During authorization, you will need to indicate that you want DistantRace to access activities. By agreeing to the connection, you allow DistantRace to access profile data, activity data, and other information in Polar Flow. Additionally, you must agree to DistantRace's terms of use and privacy policy. Once everything is checked, a connection between Polar Flow and DistantRace will be established. 2. **Synchronize Polar Flow sports activities** Once the connection is successfully established, your sports activities from Polar Flow will automatically be uploaded to distantrace.com. The uploaded sports activity will include the start time, activity duration, distance, route, and other metrics. 1. **Synchronize Daily Steps** After adding Polar Flow, it's possible to set Polar Flow as the "provider" of daily steps. This can be done in 2 ways: - by setting up the [distantrace.com app](https://distantrace.com/app) and selecting Polar as the step provider in settings. ![Daily steps in the app](/static/img/connections-with-apps/connect-with-polar-flow/img-6526-phone.png) - on the distantrace.com website by opening the ["daily steps"](https://distantrace.com/en/accounts/daily_stats/) section. ![Daily steps on distantrace.com](/static/img/connections-with-apps/connect-with-polar-flow/screenshot-2024-04-01-at-14-53-48.png) 1. **View uploaded activities** All uploaded activities can be viewed in the profile section ["Activities"](https://distantrace.com/en/accounts/my_workouts/). #### How to record activities with a mobile phone? We have prepared instructions: [How to record a sports activity using the Polar Flow app](../recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-polar-flow-app.md) #### Possible Connection Issues The most common problem for activities not appearing is different accounts. One Polar Flow account is connected on the phone, where activities are created, but another account is connected to distantrace.com. Let's go through all the steps to solve problems. DistantRace receives partial information about your Polar account, such as User ID, name, surname, birth data. You can view this information in the DistantRace "Connections" section. This information can be helpful in understanding why activities are not appearing. Below are the steps to check your Polar Flow account: 1. **Log in to Polar Flow:**\ Open the [Polar Flow website](https://flow.polar.com/) in a browser and log in. 2. **Compare User ID:**\ Once logged in, you can see the Polar User ID in the browser address. Compare this with the User ID displayed in DistantRace. If they do not match, then the wrong Polar account is connected to DistantRace. ![Polar Flow User ID](/static/img/connections-with-apps/connect-with-polar-flow/image-1711977003467.png) 1. **View account information:**\ In your profile settings, you can see Name, Surname, Email, birth data. Ensure these data match those displayed in DistantRace. Note that DistantRace displays the data that was set at the time of the connection. Changing information in Polar Flow may not reflect in DistantRace. ![Polar Flow account information](/static/img/connections-with-apps/connect-with-polar-flow/image-1711977156788.png) 1. **Check if activities are displayed:**\ In the "Diary" or "Training History" section of Polar Flow, you can see all conducted activities. If an activity does not appear here, it means it will not appear in DistantRace either. DistantRace receives only those activities that are displayed here. ![Polar Flow activities](/static/img/connections-with-apps/connect-with-polar-flow/image-1711977274198.png) 1. **Ensure the email is correct:**\ Lastly, ensure that the email address displayed in your Polar Flow account on the computer matches the email displayed in the Polar Flow app on your mobile phone. In the mobile app, the email can be found here: ![Polar Flow email in app](/static/img/connections-with-apps/connect-with-polar-flow/image-1711977484112.png) 1. **Open the "Partners" section:**\ In your Polar Flow account, look for the "Partners" section. DistantRace should appear in this list. If DistantRace is not here, it means this Polar account is not connected to DistantRace. If you find that the Polar account is connected to the wrong DistantRace account, disconnect it by pressing "Disconnect". This will delete the connection and allow connecting to the correct DistantRace account. ![Polar Flow Partners section](/static/img/connections-with-apps/connect-with-polar-flow/image-1711977439747.png) If you find discrepancies, you can take the necessary actions to resolve them. For example, disconnect the Polar Flow account from DistantRace, logging out of Polar Flow on the computer, and logging in again with the same email displayed in Polar Flow. Additionally, you can also log out in the Polar Flow mobile app and log back in with the correct email. By performing all these checks and ensuring that account data matches, you can be sure that DistantRace will start automatically receiving activities from Polar Flow. #### Manually Upload Activities It's possible to export and upload an activity file from Polar Flow. [More info here.](../extracting-activity-files/polar-gpx-download.md) --- # Connect with Strava URL: /en/connections-with-apps/connect-with-strava/ # Connect with Strava ::: warning Direct sync unavailable Strava is not listed in [Supported apps](supported-apps.md) and **direct activity sync is not available** due to Strava API limits. Use the workarounds in [Strava and DistantRace connection](strava-and-distantrace-connection.md) (manual upload, Suunto, or Wahoo). The mobile app also does not offer Strava for new connections. ::: The instructions below are kept for reference only (for example if you connected Strava before sync was disabled). If you use the Strava app daily, you have the opportunity to connect this app to distantrace.com. The Strava app offers to synchronize sports activities (not daily steps). [![](/static/img/connections-with-apps/connect-with-strava/image-1712068597748.png)](https://apps.apple.com/us/app/strava-run-bike-hike/id426826309) [![](/static/img/connections-with-apps/connect-with-strava/image-1712068604036.png)](https://play.google.com/store/apps/details?id=com.strava) 1. **Create accounts** on both distantrace.com and Strava (you might already have an account there). 2. **Connect Strava to distantrace.com** In your distantrace.com account, there is a section "[Connections](https://distantrace.com/en/accounts/social/)". Find Strava and click "Connect". 3. **Authorize data receipt from Strava** By clicking the "Connect" button, you will be redirected to the Strava website. Log in to your Strava account and authorize access to the data. To synchronize activities, you need to give access to your activities. 4. **Synchronize Strava sports activities** Once the connection is successfully established, your sports activities from Strava will automatically be loaded into distantrace.com. For a sports activity, the start time, activity time, distance, route, and other metrics will be loaded. 5. **View loaded activities** All loaded activities can be viewed in the profile section ["Workouts"](https://distantrace.com/en/accounts/my_workouts/). #### How to record activities with a mobile phone? We have prepared instructions: [How to record a sports activity using the Strava app](../recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-strava-app.md) #### Possible connection issues The most common problem is different accounts. One Strava account is connected on the phone where activities are recorded, but another account is connected to distantrace.com. You can identify the Strava account ID connected to DistantRace in the "[Connections](https://distantrace.com/en/accounts/social/)" section under the added Strava account. This ID can help determine if you have multiple Strava accounts. Here's how to check your Strava: 1. **Compare Strava account IDs:** - [Open the Strava website](https://www.strava.com/) with a web browser. - Go to your profile. - Check the user ID in the URL and compare it with the one displayed in your DistantRace "Connections" under the added Strava account. - If the user IDs differ, it indicates that a different Strava account is connected to DistantRace. - While viewing the Strava user, also check the profile name and surname and compare it with what is displayed in the distantrace.com profile under the Strava connection. ![](/static/img/connections-with-apps/connect-with-strava/image-1717145128486-34-00.png) ![](/static/img/connections-with-apps/connect-with-strava/image-1717145569476-49-36.png) 2. **Check if the account is connected to a DistantRace account:** - Open your profile settings and find the section "My Apps". - The connection to the distantrace.com profile should be visible here. If it is not here, then this Strava account is not connected to the distantrace.com app. ![](/static/img/connections-with-apps/connect-with-strava/image-1717145757477-39-09.png) 3. **Resolve multiple account issues:** - To solve this problem, first log out of your Strava account in the web browser. - Disconnect your Strava account from your DistantRace profile (this can be done in the "[Connections](https://distantrace.com/en/accounts/social/)" section). - Reconnect your Strava account to DistantRace using the same login method that was used in the Strava app on your phone. --- # Connect with Suunto URL: /en/connections-with-apps/connect-with-suunto/ # Connect with Suunto If you use Suunto devices daily, you have the opportunity to connect Suunto to distantrace.com. Suunto offers synchronization of both daily steps and sports activities. It's also possible to record sports activities on your phone with Suunto. [![](/static/img/connections-with-apps/connect-with-suunto/image-1712068597748.png)](https://apps.apple.com/lv/app/suunto/id1230327951) [![](/static/img/connections-with-apps/connect-with-suunto/image-1712068604036.png)](https://play.google.com/store/apps/details?id=com.stt.android.suunto) 1. **Create accounts** on both distantrace.com and Suunto (you may already have an account there).\ Note that a Suunto account can only be created through the Suunto mobile app. 2. **Add Suunto to distantrace.com** Your distantrace.com account has a section "[Connections](https://distantrace.com/en/accounts/social/)". Find Suunto and click "Connect". 3. **Authorize data receipt from Suunto** You will be redirected to the Suunto webpage. Log in and authorize data access. ![Suunto authorization](/static/img/connections-with-apps/connect-with-suunto/image-1711978091905.png) 1. **Synchronize Suunto sports activities** Once the connection is successfully established, your sports activities from Suunto will automatically be uploaded to distantrace.com. The uploaded sports activity will include the start time, activity duration, distance, route, and other metrics. 1. **Synchronize Daily Steps** After adding Suunto, if you have allowed DistantRace to receive daily steps, it's possible to set Suunto as the "provider" of daily steps. This can be done in 2 ways: - by setting up the [distantrace.com app](https://distantrace.com/app) and selecting Suunto as the step provider in settings. ![Daily steps in the app](/static/img/connections-with-apps/connect-with-suunto/img-6526-phone.png) - on the distantrace.com website by opening the ["daily steps"](https://distantrace.com/en/accounts/daily_stats/) section. ![Daily steps on distantrace.com](/static/img/connections-with-apps/connect-with-suunto/screenshot-2024-04-01-at-14-53-48.png) 1. **View uploaded activities** All uploaded activities can be viewed in the profile section ["Activities"](https://distantrace.com/en/accounts/my_workouts/). #### How to record activities with a mobile phone? We have prepared instructions: [How to record a sports activity using the Suunto app](../recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-suunto-app.md) #### Possible Connection Issues The most common issue for activities not appearing is different accounts. One Suunto account is connected on the phone, where activities are created, but another account is connected to distantrace.com. Let's go through all the steps to solve problems. DistantRace only receives the Suunto user name, which is crucial to understand if the connection is correctly established. Next, step by step: 1. **Open the Suunto app on your phone:**\ Suunto does not have a webpage available for a computer, so you need to open the Suunto app and compare the Suunto data. 2. **Open account settings:**\ Once logged in, open your profile. 3. **Go to profile settings:**\ In your profile, click on "settings". 4. **View account information:**\ In the account settings, you should be able to find your email and username. Make sure it matches what is shown in DistantRace under connections. If the usernames do not match, it means a different Suunto account is connected to DistantRace than what is set up on your phone. 5. **Resolve discrepancies:** If the account does not match what is set up in DistantRace, you need to go to "[Connections](https://distantrace.com/en/accounts/social/)" and disconnect the Suunto account. After disconnecting, re-add it by indicating the correct username on the Suunto webpage. ![Suunto data](/static/img/connections-with-apps/connect-with-suunto/image-1711978698414.png) #### Manually Upload Activities It's possible to export and upload an activity file from Suunto. [More info here.](../extracting-activity-files/suunto-fit-download.md) --- # Connect with Under Armour (MapMyRun / MapMyWalk / MapMyRide / MapMyHike) URL: /en/connections-with-apps/connect-with-under-armour-mapmyrun-mapmywalk-mapmyride-mapmyhike/ # Connect with Under Armour (MapMyRun / MapMyWalk / MapMyRide / MapMyHike) If you use the MapMy... app daily, you have the opportunity to connect this app to distantrace.com. The MapMy... apps offer to synchronise sports activities (not daily steps). [![](/static/img/connections-with-apps/connect-with-under-armour-mapmyrun-mapmywalk-mapmyride-mapmyhike/image-1712068597748.png)](https://apps.apple.com/lv/app/map-my-run-by-under-armour/id291890420) [![](/static/img/connections-with-apps/connect-with-under-armour-mapmyrun-mapmywalk-mapmyride-mapmyhike/image-1712068604036.png)](https://play.google.com/store/apps/details?id=com.mapmyrun.android2) 1. **Create accounts**\ Make sure you have an account created for both the Under Armour app (one of MapMyRun, MapMyRide, MapMyWalk, MapMyHike, or MapMyFitness) and DistantRace. It is important that Under Armour provides access with the same username and password for all applications, so different accounts are not necessary. This means that even if you have registered with MapMyRun, it does not prevent you from cycling and registering for such activities. 2. **Connect Under Armour to distantrace.com** In your distantrace.com account, there is a section "[Connections](https://distantrace.com/en/accounts/social/)". Find "Under Armour" and click "Connect". 3. **Authorize data reception from Under Armour** You will be redirected to the Under Armour homepage. Log in and authorize data access. ![](/static/img/connections-with-apps/connect-with-under-armour-mapmyrun-mapmywalk-mapmyride-mapmyhike/image-1711990616220.png) 1. **Synchronise Under Armour sports activities** Once the connection is successfully created, your sports activities from Under Armour will automatically be loaded into distantrace.com. The start time, activity time, distance, route and other metrics of the sports activity will be loaded. 1. **View loaded activities** All loaded activities can be viewed in the profile section ["Activities"](https://distantrace.com/en/accounts/my_workouts/). #### How to record activities with a mobile phone? We have prepared instructions: [How to record sports activities using the Map My Walk/Run/Ride app](../recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-map-my-walkrunride-app.md) #### Potential connection issues The most common issue is that activities do not appear because of different accounts. One Under Armour account is connected to the phone, where activities are created, but another account is connected to distantrace.com. But let's go through all the steps to resolve the issues. Under Armour consists of multiple apps, such as Map My Fitness, Map My Walk, Map My Run, and Map My Ride. After connection, DistantRace receives Under Armour profile information such as name, surname, date of birth and e-mail address. You can view this information in the "Connections" section to make sure the correct Under Armour account is connected. Next, step by step: 1. **Compare the email address:**\ The easiest way to check if the correct Under Armour account is connected is to compare the e-mail address displayed in the MapMy... app and DistantRace. Open the MapMy... app and press "edit". Here you will find your information - e-mail, name, surname, birth information. If the email address does not match the one displayed in the DistantRace section "[Connections](https://distantrace.com/en/accounts/social/)", it means that another Under Armour account is connected. ![](/static/img/connections-with-apps/connect-with-under-armour-mapmyrun-mapmywalk-mapmyride-mapmyhike/image-1711991157895.png) 2. **View the account on the Under Armour website:**\ You can also view your Under Armour account in a browser: [MapMyFitness](https://www.mapmyfitness.com/account/my_profile) / [MapMyRun](https://www.mapmyrun.com/account/my_profile) / [MapMyWalk](https://www.mapmywalk.com/account/my_profile). Go to settings and there you will find the e-mail address associated with the Under Armour account. Also, under "Connected Apps" "DistantRace" should be displayed. If you do not see DistantRace, this means that another Under Armour account is connected to DistantRace. ![](/static/img/connections-with-apps/connect-with-under-armour-mapmyrun-mapmywalk-mapmyride-mapmyhike/image-1711991525509.png) 1. **Check if your activities appear:**\ Check if your activities in the Under Armour app appear on the [homepage](https://www.mapmyfitness.com/dashboard). If the activity does not appear here, it also did not reach DistantRace. Make sure the activity syncs successfully from the MapMy... app and there is an internet connection to send the activity to the Under Armour server. 2. **Delete the connection:**\ If you find that you have several Under Armour accounts, it is recommended to disconnect Under Armour from DistantRace. But before reconnection, make sure you are logged out of all Under Armour accounts in your browser, you may need to clear cookies, or use a different browser. It is recommended to use a "Private browsing" window to avoid potential conflicts with incorrect account connections. This process will ensure that the correct Under Armour account is connected and you will be able to successfully submit your activities to DistantRace. --- # Connect with Wahoo URL: /en/connections-with-apps/connect-with-wahoo/ # Connect with Wahoo If you use the Wahoo app or devices on a daily basis, you have the option to connect Wahoo with distantrace.com. Wahoo offers the synchronization of sports activities. [![](/static/img/connections-with-apps/connect-with-wahoo/image-1712068597748.png)](https://apps.apple.com/lv/app/wahoo/id391599899) [![](/static/img/connections-with-apps/connect-with-wahoo/image-1712068604036.png)](https://play.google.com/store/apps/details?id=com.wahoofitness.fitness) 1. **Create accounts** on both distantrace.com and Wahoo (you probably already have an account there). 2. **Add Wahoo to distantrace.com** In your distantrace.com account, there is a section "[Connections](https://distantrace.com/en/accounts/social/)". Find Wahoo and click "Connect". 3. **Authorize data receipt from Wahoo** You will be redirected to the Wahoo homepage. Log in and authorize data access. 4. **Synchronize Wahoo sports activities** Once the connection is successfully established, your sports activities from Wahoo will automatically be uploaded to distantrace.com. The start time, duration, distance, route, and other metrics will be uploaded for the sports activity. 1. **View uploaded activities** All uploaded activities can be viewed in the profile section ["Activities"](https://distantrace.com/en/accounts/my_workouts/). #### How to record activities with a mobile phone? We have prepared instructions: [How to record a sports activity using the Wahoo Fitness app](../recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-wahoo-fitness-app.md) #### Possible problems with the connection The most common problem is that activities do not appear due to different accounts. One Wahoo account is connected on the phone, where activities are created, but another account is connected to distantrace.com. However, let's go through all the steps to eliminate problems. From Wahoo, DistantRace receives your name, surname, birth data, and e-mail address, which is essential to understand whether the connection is correctly established. Then step by step: 1. **Compare the information with what appears in the Wahoo app:** - Open your Wahoo mobile app and open the "Profile" view. - Here you will find all the data related to your Wahoo account. - Compare the information displayed in the app with what you see on the DistantRace page "[Connections](https://distantrace.com/en/accounts/social/)". - Keep in mind that DistantRace data reflects information as it was at the time the connection was established, and all subsequent changes may not be reflected. ![](/static/img/connections-with-apps/connect-with-wahoo/image-1712040661718.png) 1. **Reconcile any discrepancies:** - If you notice that the email address associated with your Wahoo account on the DistantRace site differs from the email displayed in the Wahoo mobile app, it indicates that you may be using another Wahoo account on your mobile device. - In this case, disconnect your Wahoo account from DistantRace. This can be done in the section "[Connections](https://distantrace.com/en/accounts/social/)". - Reconnect your Wahoo account to DistantRace using the same email that is used in your Wahoo mobile app. --- # Connect to DistantRace with one of the sports apps URL: /en/connections-with-apps/data-synchronization-problems/connect-to-distantrace-with-one-of-the-sports-apps/ # Connect to DistantRace with one of the sports apps You can easily access your DistantRace account using sports app access data. This feature simplifies the login process and allows seamless switching between accounts. Here's how to do it: 1. **Log in with a sports app:**\ When you're on the login page, press "other apps". ![](/static/img/connections-with-apps/data-synchronization-problems/connect-to-distantrace-with-one-of-the-sports-apps/image-1712066305852.jpg) 2. **Choose a sports app:**\ From the list, choose your sports app that is connected to your DistantRace account. 3. **Enter your sports app username and password:**\ You will need to log in with the sports app access data (e.g., Garmin, Polar, Fitbit, etc.). 4. **Access your DistantRace account:**\ After you have entered your access data, you will reach your DistantRace account that is connected to the specific sports service. This method allows easy access to your DistantRace account associated with a specific sports app. If you ever want to switch the connection to another DistantRace account, you can simply delete the existing connection and restore it using the desired DistantRace account. By offering this login option, DistantRace provides users with a convenient way to manage and access linked accounts without hassle. --- # Multiple DistantRace User Accounts URL: /en/connections-with-apps/data-synchronization-problems/multiple-distantrace-user-accounts/ # Multiple DistantRace User Accounts Users may unknowingly create multiple "DistantRace" user accounts. This can happen for several reasons, such as using different emails when logging into their "DistantRace" account, using a social media account to log in that has not previously been linked to a "DistantRace" account, or using "DistantRace" both in the mobile app and web browser version with separate registrations in each. If you suspect that you have created multiple "DistantRace" user accounts, here is how you can check. 1. **Check your email.** Both in the mobile app and web browser, in the ["Profile" section](https://distantrace.com/en/accounts/profile/), you can see the email addresses associated with your account. If you also use the mobile app and the email differs in both places, then you have 2 accounts, and data between these accounts will not be synchronized. ![](/static/img/connections-with-apps/data-synchronization-problems/multiple-distantrace-user-accounts/image-1712066188302.jpg) 2. **Use password recovery.** You can check if a "DistantRace" user account has been created with your email by using the [password recovery functionality](https://distantrace.com/en/accounts/password/reset/). Enter your email addresses. If you receive a letter from "DistantRace" with further instructions for password recovery, it means that you have created an account with such an email. This way, you can check all the email addresses you use. If you find that multiple "DistantRace" accounts have been created, there are several options to resolve this. 1. **Delete the unnecessary account.** Log into the account you will not use, disconnect all sports apps and social accounts from it, and [delete the account](https://distantrace.com/en/accounts/profile/delete/) or simply log out on all devices you use. Then log into "DistantRace" with the account you will use consistently, and you can add all the sports apps anew. 2. **Merge accounts** If both accounts contain data you need, use the in-app flow when connecting social login — [Resolving duplicate social accounts](../../joining-events/resolving-duplicate-social-accounts.md). For email-only duplicates, write to support@distantrace.com with all account emails. --- # Multiple user accounts in a sports app URL: /en/connections-with-apps/data-synchronization-problems/multiple-user-accounts-in-a-sports-apps/ # Multiple user accounts in a sports app **\ The essence of the problem.** It may happen that multiple user accounts have been inadvertently created in one of the sports apps you wish to connect to your 'DistantRace' account, which can create certain ambiguities and lead to data synchronization problems. There are several scenarios in which user accounts may accidentally be created. 1. **Different login methods:**\ It is possible that the user account was initially created using an email and password, but on subsequent logins, one of the social media accounts was used, thereby creating 2 independent profiles. 2. **Simultaneous use of the mobile app and web browser version:**\ If you use both the mobile app and the web browser version simultaneously, it is possible that 2 separate accounts have been created in each. Especially if a different login method was used in each. 3. **Shared use of a device.**\ There are cases where users in a household use one device and one sports app. If one user does not log out after using it, and another user tries to connect the service to "DistantRace", then the accounts may overlap.\ **Check if multiple accounts have been created.** To check if you have accidentally created multiple accounts in any of the sports apps, follow the steps described below. 1. **Go to the "Connections" section:**\ Log into your "DistantRace" account through a web browser and go [to the "Connections" section](https://distantrace.com/en/accounts/social/) in your profile. Here you will find all the information we have about each of your connected external service accounts. 2. **Check the available information:**\ Under the connected service, you will find the data we have about the user account of the connected external service. There will also be a help link that describes in detail how to use this data and check your external service account with the available data. **Connect the correct account.** If it is found that you have multiple sports app accounts, then follow the steps described below to connect the correct account to your "DistantRace" profile and resolve synchronization issues. 1. **Disconnect the sports app.**\ Go [to the "Connections" section](https://distantrace.com/en/accounts/social/) and disconnect the sports app from your "DistantRace" account. 2. **Log out of the sports app.**\ Log out of the sports app on all devices where you use it. If you can't find how to log out, you can also delete the app and reinstall it. 3. **Use the same login details.**\ Re-add the sports app to your "DistantRace" account and log in anew on your devices. Use the same login details and method everywhere. If you use an email and password, use the same email everywhere. Conversely, if you use, for example, one of the social media accounts, then use the same social account everywhere to establish connections. --- # The most common reasons for data synchronization issues URL: /en/connections-with-apps/data-synchronization-problems/the-most-common-reasons-for-data-synchronization-issues/ # The most common reasons for data synchronization issues Is your sports app connected, but data between your sports app and "DistantRace" is not being synchronized? Below are the most common data synchronization issues and their solutions to help you resolve technical difficulties. 1. **Connection of the sports app.** The first step you can take is to check which external services are connected to your "DistantRace" account. Through a web browser, go to the ["Connections"](https://distantrace.com/en/accounts/social/) section in your profile. If there is no "Disconnect" button and a green (or yellow) icon next to the service logo you plan to use, it means that the service is not connected - press the "Connect" button and follow further instructions. [Look here](../supported-apps.md) for more detailed information on how to connect external services to your "DistantRace" account. 2. **Initiation of data synchronization.** Automatic data synchronization between "DistantRace" and the chosen external service only starts after you have connected this service. This means that activities recorded before connecting the service will not be synchronized. To access historical activities use the manual synchronization by date option or you can upload the activity file if available. These options are available in the ["Activities"](https://distantrace.com/en/accounts/my_workouts/) section of your profile. If using manual synchronization, keep in mind that each service individually determines the time slice in which "DistantRace" can access historical data, and some services do not allow access to historical data recorded before connecting the service. 3. **The connection is no longer current.** If you have not used "DistantRace" or the connected external service for some time, the connection may no longer be current and data synchronization may not occur. To resolve this [go to "Connections"](https://distantrace.com/en/accounts/social/) in your profile, disconnect the service and connect it again. This will restore the connection and automatic data synchronization will resume. 4. **Source of step data.** If step data is not being synchronized, check if your chosen service is set as the step data source. To do this, go to the ["Daily Steps"](https://distantrace.com/lv/konts/ikdienas_soli/) page in your profile. It is also possible that you have not given us permission to access your step data when connecting the external service. This is a typical case for "Garmin" users. In this case, it is necessary to disconnect and reconnect the chosen service, marking all permissions displayed in the chosen service's connection window (in the case of Garmin, "Health Data"). 5. **Multiple user accounts in the chosen sports app.** Even if everything seems to be correctly connected, data may not be synchronized because multiple accounts have been created in the chosen service. It's possible that the app on your phone records data in a different account than the one connected to "DistantRace". To resolve this, disconnect the sports app from your "DistantRace" account and also log out from the sports app on your phone (you can also delete the app and reinstall it). Then reconnect the chosen service to your "DistantRace" account anew and log into the app on your phone, in both cases using the same login method and data (email/password, "Gmail" or "Facebook" account). [Here you can learn more](multiple-user-accounts-in-a-sports-apps.md) about multiple accounts in sports apps. 6. **Multiple DistantRace accounts.** Make sure you haven't accidentally created multiple "DistantRace" user accounts. This problem can arise if you filled out the registration form several times. This can happen if you used 2 different login methods when connecting. For example, the first time using email and password, and the next time a "Gmail" or "Facebook" login method. Remember, all external services (including social account connections) can be managed in the ["Connections"](https://distantrace.com/en/accounts/social/) section of your profile. [Here you can learn more](multiple-distantrace-user-accounts.md) about dealing with multiple "DistantRace" accounts. --- # Troubleshooting Specific Service Issues URL: /en/connections-with-apps/data-synchronization-problems/troubleshooting-specific-service-issues/ # Troubleshooting Specific Service Issues Below, we have compiled all the services and possible ways to find why activities or daily steps are not synchronizing. Click on the service to open instructions: ![Garmin Connect](/static/img/connections-with-apps/data-synchronization-problems/troubleshooting-specific-service-issues/service-garmin.png) [Garmin Connect](../connect-with-garmin-connect.md#possible-connection-issues) ![service_polar.png](/static/img/connections-with-apps/data-synchronization-problems/troubleshooting-specific-service-issues/service-polar.png) [Polar Flow](../connect-with-polar-flow.md#possible-connection-issues) ![service_suunto.png](/static/img/connections-with-apps/data-synchronization-problems/troubleshooting-specific-service-issues/service-suunto.png) [Suunto](../connect-with-suunto.md#possible-connection-issues) ![service_fitbit.png](/static/img/connections-with-apps/data-synchronization-problems/troubleshooting-specific-service-issues/service-fitbit.png) [Fitbit](../connect-with-fitbit.md#possible-connection-issues) ![service_uacf.png](/static/img/connections-with-apps/data-synchronization-problems/troubleshooting-specific-service-issues/service-uacf.png) [Under Armour (MapMyRun / MapMyWalk / MapMyRide / MapMyHike)](../connect-with-under-armour-mapmyrun-mapmywalk-mapmyride-mapmyhike.md#potential-connection-issues) ![service_decathlon.png](/static/img/connections-with-apps/data-synchronization-problems/troubleshooting-specific-service-issues/service-decathlon.png) [Decathlon Coach](../connect-with-decathlon-coach.md#potential-connection-issues) ![service_health_mate.png](/static/img/connections-with-apps/data-synchronization-problems/troubleshooting-specific-service-issues/service-health-mate.png) [Health Mate (Withings)](../connect-with-health-mate-withings.md#possible-connection-issues) ![service_wahoo.png](/static/img/connections-with-apps/data-synchronization-problems/troubleshooting-specific-service-issues/service-wahoo.png) [Wahoo](../connect-with-wahoo.md#possible-problems-with-the-connection) --- # How to Set Up a Step Data Source in the DistantRace App? URL: /en/connections-with-apps/how-to-set-up-a-step-data-source-in-the-distantrace-app/ # How to Set Up a Step Data Source in the DistantRace App? The DistantRace app does not count steps on its own; therefore, you need to use an external service to synchronize your daily steps with the DistantRace app. For provider choices (Apple Health, Health Connect, phone pedometer, Garmin, and more), see [Step sync setup](../mobile-app/step-sync-setup.md). To do this, you need to set up a "step data source" or connect your DistantRace account with one of the services where steps are tracked. Once this is set up, your steps will automatically synchronize with DistantRace and will be counted in all challenges you participate in. Follow the instructions below to set up a step data source in the DistantRace app. 1. At the bottom of the app, **select the "person" icon** to open your account settings. 2. Click on the **"Steps Provider"** menu to open the available services. 3. **Choose the service** with which your daily steps will be synchronized. 4. You will then be redirected to the selected service's views, where you will need to **enter the respective service account details and grant permission** to synchronize your data with DistantRace. ![Screenshot 2024-11-03 at 19.12.35.png](/static/img/connections-with-apps/how-to-set-up-a-step-data-source-in-the-distantrace-app/screenshot-2024-11-03-at-19-12-35.png) ![Screenshot 2024-11-03 at 19.13.31.png](/static/img/connections-with-apps/how-to-set-up-a-step-data-source-in-the-distantrace-app/screenshot-2024-11-03-at-19-13-31.png) ![Screenshot 2024-11-03 at 19.09.29.jpeg](/static/img/connections-with-apps/how-to-set-up-a-step-data-source-in-the-distantrace-app/screenshot-2024-11-03-at-19-09-29.jpeg) --- # How to submit daily steps with an Android phone? URL: /en/connections-with-apps/how-to-submit-daily-steps-with-an-android-phone/ # How to submit daily steps with an Android phone? If you are an Android user and want to effortlessly synchronize step data with DistantRace, you can do so using the DistantRace mobile app. A detailed guide is provided below to help you submit step data. You have 2 options for submitting daily step data: - Using Health Connect (should be used to get steps from [Samsung Health](how-to-submit-steps-with-samsung-health.md) and other services/apps) - Using Google Fit We will describe each of these services below. [![](/static/img/connections-with-apps/how-to-submit-daily-steps-with-an-android-phone/image-1712068604036.png)](https://distantrace.com/app) #### Health Connect Health Connect is a new way to aggregate sports activities and daily step data on an Android phone. This app itself does not count steps, but acts as an intermediary - there are apps that can write and apps that can read the information. DistantRace reads the step data recorded in this intermediary program. 1. **Install Health Connect:**\ To sync steps from Health Connect, make sure you're **using Android 14 or higher**. If you're on a version below Android 14, you won't be able to sync steps. In that case, use Google Fit and connect it to the DistantRace app. 2. **Install the DistantRace app:**\ The DistantRace app is also available on the [Google Play Store](https://distantrace.com/app). Install it. 3. **Give DistantRace permission to read step data:** ![](/static/img/connections-with-apps/how-to-submit-daily-steps-with-an-android-phone/image-1712042764664.png) 1. **Make sure there are apps that send steps to Health Connect:**\ For DistantRace to receive steps, there must be a step provider. Open Health Connect and check if there is an app that records steps. ![Step data flow diagram](/static/img/connections-with-apps/how-to-submit-daily-steps-with-an-android-phone/drawing-1-1712129160.png) ❗Please note that we can only get data from Health Connect when you have opened the DistantRace app. Therefore, remember to occasionally open the app so that the latest steps reach DistantRace. #### Google Fit If you want to set Google Fit as your steps provider, then: - You need to install Google Fit [from the Google Play Store](https://play.google.com/store/apps/details?id=com.google.android.apps.fitness) - Go to the DistantRace app settings and choose Google Fit as your steps provider (or choose Google Fit when you first connect to the app). ![](/static/img/connections-with-apps/how-to-submit-daily-steps-with-an-android-phone/image-1712043149718.png) #### Troubleshooting On Android phones, a common problem with Health Connect is that there is no app installed that records steps into Health Connect, therefore DistantRace always shows 0 steps. If so, open Health Connect and check if there is any app writing. As an alternative, you might want to install [Google Fit](https://play.google.com/store/apps/details?id=com.google.android.apps.fitness) as well and let Google Fit write steps into Health Connect. We also recommend regularly opening DistantRace and the app of the service that writes the steps, to ensure that steps are successfully retrieved from the phone. --- # How to submit steps with another Android app? URL: /en/connections-with-apps/how-to-submit-steps-with-another-android-app/ # How to submit steps with another Android app? If the Android application synchronizes steps with Health Connect, these steps can also be received by DistantRace. Let's look at ways to understand if there is an application installed on the phone that can also collect daily steps. **Download the DistantRace app and connect to Health Connect:**\ If you haven't done it yet, go [to this section](how-to-submit-daily-steps-with-an-android-phone.md#health-connect) where it is explained how this can be successfully accomplished. **Allow other Android applications to record steps to Health Connect:** 1. Open settings on your mobile phone. 2. Find "Health Connect" and open it. 3. Press "App permissions" and find your desired application (e.g., Samsung Health). 4. Various permission options will be offered. If you wish, you can accept all permissions. Otherwise, find the "allow to write" permission and enable this permission. This allows the selected application to write step data inside Health Connect, which DistantRace can then read and synchronize with our server to perform result calculations. 5. Go back and click on "Data and access". In the "Browse data" section, find "Activity" and then in the "Manage data" section set "App priority". Pull the necessary application upwards to make sure that steps will be received from the desired application. This should be done if more than one application is allowed to write data to "Health Connect". **Automatic data synchronization:** Every time you open the DistantRace application, it will receive the latest step data from Health Connect. When the device is connected to the internet, the application automatically sends this data to our server. **Challenge result calculation:** When your step data reaches our server, we perform the necessary calculations to determine your challenge results. This seamless integration provides the opportunity to actively participate in various challenges and events. ![](/static/img/connections-with-apps/how-to-submit-steps-with-another-android-app/image-1712055916985.png) ![](/static/img/connections-with-apps/how-to-submit-steps-with-another-android-app/image-1712056030207.png) ![](/static/img/connections-with-apps/how-to-submit-steps-with-another-android-app/image-1712056310257.png) By using the DistantRace mobile app with Health Connect, you can effectively synchronize your step data from third-party applications with DistantRace. --- # How to submit steps with Samsung Health? URL: /en/connections-with-apps/how-to-submit-steps-with-samsung-health/ # How to submit steps with Samsung Health? Health Connect is the recommended way to obtain data from Samsung Health (both Samsung phones and watches). Note that we can only obtain data if Health Connect is installed on the phone. Health Connect is built in from Android 14. If you have an older version, you need to use Google Fit. 1. **Ensure that you are using at least Android 14** 2. **Allow Samsung Health to connect with Health Connect**\ Go to the Samsung Health app, open settings and choose Health Connect. Allow all necessary permissions for Samsung Health. 3. **Enable Samsung Health sync with Samsung Cloud**\ Without enabling this, Samsung Health doesn't sync with Health Connect. 4. **Allow access to Health Connect in the DistantRace app**\ More information on how to do this can be [found here](how-to-submit-daily-steps-with-an-android-phone.md#health-connect). After creating the connection, make sure the steps appear in DistantRace. The initial step retrieval may take a few minutes. If they do not appear after some time, contact DistantRace support. [![Samsung Health](https://img.youtube.com/vi/fGBIkqD_w8M/0.jpg)](https://www.youtube.com/watch?v=fGBIkqD_w8M) #### How to submit sports activities from Samsung Health Samsung Health does not directly send sports activities to DistantRace, but it is possible to [add Samsung Health to MapMyRun and MapMyRun to DistantRace.](samsung-health-mapmyrun-distantrace.md) --- # How to Sync Steps with a Huawei Watch? URL: /en/connections-with-apps/how-to-sync-steps-with-a-huawei-watch/ # How to Sync Steps with a Huawei Watch? Unfortunately, Huawei is not a friendly company when it comes to allowing us to synchronize data from Huawei Health. Therefore, if you want to synchronize steps from your Huawei watch to DistantRace, you'll need to use an additional intermediary service - the Health Sync app. 1. DistantRace will sync steps from Health Connect. Set Health Connect as the step data source in the DistantRace app. More here: [How to submit daily steps with an Android phone?](how-to-submit-daily-steps-with-an-android-phone.md) 2. Download the [Health Sync app](https://healthsync.app/). 3. Follow the instructions in the Health Sync app. You need to give permission for Huawei Health to send steps to Health Connect. Once all apps are connected, your steps will flow from the Huawei watch to DistantRace as follows: Huawei Watch -> Huawei Health App -> Health Sync App -> Health Connect App -> DistantRace App Yes, this may seem complicated, but unfortunately, this is currently the only way to sync steps from a Huawei watch to the DistantRace app. Hopefully, Huawei will make improvements soon to allow for an easier step submission process in the app. --- # How to use Apple Health? URL: /en/connections-with-apps/how-to-use-apple-health/ # How to use Apple Health? If you use an Apple Watch for activity tracking or step counting or use "Apple Health" without a watch, here's what you need to do to sync your data with your DistantRace account: [![](/static/img/connections-with-apps/how-to-use-apple-health/image-1712068597748.png)](https://apps.apple.com/lv/app/distant-race-app/id6447062298) 1. **Download the DistantRace mobile app.**\ Start by [downloading the DistantRace app](https://apps.apple.com/lv/app/distant-race-app/id6447062298) from the official "Apple" store "App Store". If you have already created your DistantRace user account, then log in to the app using the same authentication parameters that you use to access your account in the web browser. If you haven't created a user account yet, then you'll have to do that when setting up the app. But then, when logging into DistantRace through a web browser, use the same login parameters that you use in the mobile app. 2. **Give access to your Apple Health data.**\ After logging in or creating an account, you will need to allow the DistantRace app to access your data stored in the "Apple Health" app. This will allow DistantRace to access your recorded activity and step data. If you skipped this step or want to make changes, you can do so in your phone's settings. ![](/static/img/connections-with-apps/how-to-use-apple-health/image-1712041642730.png) 3. **Apple Health data in the DistantRace app.**\ Once the DistantRace app has received permission to access "Apple Health" data, it will be displayed in the app. Steps are displayed on the main screen, while recorded activities are displayed in a separate activity screen. Steps are automatically synchronized with the DistantRace server, but to synchronize activities, you need to select which ones you want to synchronize. 4. **Activity synchronization.**\ To access the activity list, in the main view of the app, tap the "Workouts in Apple Health" button. You will see a view that displays the same activities available in the "Apple Health" app. These activities are only available locally on your phone, so they won't be found in your DistantRace profile and aren't included in any of the virtual event results. Find the activity you want to sync and press the "Send" button. The activity will be processed and all results for the events you're participating in will be recalculated. ![](/static/img/connections-with-apps/how-to-use-apple-health/image-1712041716443.png) **❗❗❗ Important notes:** - "Apple Health" on your phone operates as a centralized location where all fitness data from various sports apps present on your phone are stored, provided those apps have the respective rights. But only for those activities, which are recorded with the "Apple" watch, will GPS data (activity route) be available in the "Apple Health" app. Therefore, with "DistantRace" you can synchronize all activities present in "Apple Health", but if an activity is not recorded with the "Apple" watch, then "DistantRace" will not have access to the activity's GPS data. - To participate in virtual competitions, GPS data is a requirement. GPS data might also be a mandatory requirement for participating in virtual challenges. This depends on the rules of each challenge set by the organizer of each challenge. If an activity does not have GPS data, it will not be included in the challenge results. - It is vitally important to log into the DistantRace app with the exact same user profile that you use to log into DistantRace through a web browser. If multiple accounts are created, the data will not synchronize with each other. --- # Intro URL: /en/connections-with-apps/intro/ # Intro DistantRace allows adding many sports apps to aggregate sports activities. Apps fall into 2 categories: sports apps and connection apps (such as Facebook, Google, Apple). #### What are external apps? An external app is an additional app/service that enhances the distantrace.com experience. You will have your own account in the external app/service, which can be easily connected to distantrace.com in the "[Connections](https://distantrace.com/en/accounts/social/)" section. ##### Integration with sports apps With this integration, you have the opportunity to connect distantrace.com with the world's leading/best sports apps. Integration with sports apps allows participants to use their favorite sports app to register sports activity or daily steps (DIY: there's a separate article about daily steps), which automatically goes to distantrace.com and is added to a challenge or competition. ##### Authorization apps To make it easier to log in to distantrace.com, you can use Facebook, Google, or Apple ID, so there's no need to enter a password, just click on the icon of the chosen service. #### How does activity synchronization work? DistantRace offers to synchronize activities with the most popular sports apps. Activity synchronization allows you to participate in virtual races and challenges and follow your progress. To give an idea of how activity synchronization technically occurs, we have prepared a brief description of how it happens and what the participant needs to do to have their recorded activities synchronized with DistantRace. 1. **Choose your activity recording app.**\ Start by selecting the app with which you will record activities. We have prepared a summary of which apps you can choose and what to pay attention to when making a choice. Find the summary [here](supported-apps.md). Once you've made your choice, create your user account in the sports app. 2. **Add the sports app to DistantRace.**\ Your DistantRace profile and the profile you created in the sports app are two independent parts. Even if you created both profiles with the same email, it doesn't connect them in any way. Therefore, you need to link them, thereby giving permission for the sports app to send your data to DistantRace. Remember, you should use the login details of the sports app account (not DistantRace) during the linking process. You can add sports apps in the [profile section "Connections"](https://distantrace.com/en/accounts/social/). 3. **Data Synchronization.**\ Once both accounts are linked, DistantRace begins receiving your activity data from the chosen sports app. The activity data includes the start and end time of the activity, distance, route GPS data (if available), and other indicators depending on the chosen service.\ ❗❗❗**Note:** Remember, data synchronization starts only from the moment both accounts are linked. All historical data recorded before linking the accounts will not be synchronized. 4. **Record activities.**\ The process of recording activities may slightly differ for each sports app. Typically, you start recording an activity by pressing a "Start", "Play", or "plus" button. Then, you select the type of sport for the activity and perform the activity with the device, saving the activity upon completion. After finishing, the activity is usually saved on your device. 5. **Synchronization with the sports app's server.**\ Once your phone has an active internet connection, the activity will be sent to the sports app's service. If you are using a sports watch to record activities, the activity will be sent to your phone when there is an active Bluetooth connection and subsequently to the server. 6. **Sending the activity to DistantRace.**\ Once the activity is saved in the sports app's server, it checks which other services are authorized to sync your activity. If DistantRace is one of such services, then the activity will be sent to DistantRace. 7. **Activity processing.**\ When we receive your activity, we check in which virtual races and challenges you are participating and calculate the results from your activity data. You can find the activity in the [profile section "Activities"](https://distantrace.com/en/accounts/my_workouts/) and check where your activity has been counted and how it affects your results. Although the process of activity synchronization might seem a bit complicated at first, it's important to understand how your data is transferred from one service to another. The good news is that activity synchronization is an automatic process, and you only need to connect your sports app to DistantRace once. After that, all that's left is to enjoy your sports activities and appreciate the achievements. #### How are daily steps synchronized? "DistantRace" offers not only to synchronize activities but also daily steps counted by your phone or sports watch. You can use daily step data to participate in various types of step challenges. To start daily step synchronization, you need to choose the service with which daily steps will be counted. [Check here](supported-apps.md) for the available step counting apps that you can connect to your "DistantRace" account and choose the most suitable service for your needs and capabilities. Below is a description of how the step synchronization process works between "DistantRace" and your step recording device. 1. **If you use a sports watch supported by DistantRace for daily step counting.**\ If you are using a service's sports watch that can be [directly connected to "DistantRace"](https://distantrace.com/en/accounts/social/), then nothing additional needs to be done. Connect the used service to your "DistantRace" account, and daily steps will be synchronized with "DistantRace". You can also use the "DistantRace" mobile app to create a connection. Then, your daily steps in the sports watch will also be displayed in the DistantRace app. 2. **If you count daily steps with "Apple Health".**\ If you use "Apple Health", including counting steps with an "Apple" watch, then install the [DistantRace mobile app](https://apps.apple.com/lv/app/distant-race-app/id6447062298) on your phone and give the app permission to access your "Apple Health" data. Once done, your daily step data will automatically be synchronized with "DistantRace". 3. **If you use an "Android" phone or another sports watch**\ In this case, to synchronize your daily steps, you will need to use one of the step counting helper apps - "Google Fit" or "Health Connect". Once one of these apps is installed on your phone, connect it also to the ["DistantRace" mobile app](https://play.google.com/store/apps/details?id=com.distantrace.app). This way, the service used for step counting will send steps to "Google Fit" or "Health Connect", and "DistantRace" will be able to access these step data. 4. **Data synchronization**\ Once all connections are made, everything becomes quite simple: you just need to move, carrying the device with which you count steps, and the chosen services will synchronize the steps to "DistantRace". As soon as the step data reaches "DistantRace", it updates the results in all challenges you are participating in. 5. **Follow your progress**\ By logging into your "DistantRace" profile through a web browser, you can view all synchronized data. Go to the profile section ["Daily steps"](https://distantrace.com/en/accounts/daily_stats/). Here, you can not only view all synchronized data but also see the time when the last synchronization between "DistantRace" and your step counting device took place. Here you can also change your step data source if you wish to make changes to the service choice with which steps are counted. --- # Samsung Health + MapMyRun + DistantRace URL: /en/connections-with-apps/samsung-health-mapmyrun-distantrace/ # Samsung Health + MapMyRun + DistantRace Samsung Health does not send activities directly to DistantRace, but it is possible to use MapMyRun to receive activities. 1. **Download the MapMyRun app and create an account.** 2. **Connect MapMyRun to DistantRace:**\ [Read here on how to connect MapMyRun with DistantRace.](connect-with-under-armour-mapmyrun-mapmywalk-mapmyride-mapmyhike.md) 3. **Connect MapMyRun to Samsung Health**:\ In the MapMyRun app, go to "Apps & Devices" and find Samsung Health. Press "connect" to link accounts. The app will ask what information you want to receive from Samsung Health. Check all necessary options and click "Connect". 4. **Record your sporting activity:**\ Use the Samsung Health app to record your workouts. Start the activity, and when finished, your workout data will automatically be sent to both MapMyRun and DistantRace without any additional steps. This ensures that your workouts are conveniently shared across different platforms, allowing you to participate in challenges and effortlessly track your sports activities. ![Samsung Health to MapMyRun to DistantRace data flow diagram](/static/img/connections-with-apps/samsung-health-mapmyrun-distantrace/drawing-1-1712129583.png) ![](/static/img/connections-with-apps/samsung-health-mapmyrun-distantrace/image-1712060131113.png) ![](/static/img/connections-with-apps/samsung-health-mapmyrun-distantrace/image-1712060285185.png) --- # Strava and DistantRace connection URL: /en/connections-with-apps/strava-and-distantrace-connection/ # Strava and DistantRace connection "Strava" has developed solutions that allow activity synchronization with DistantRace, and we are also ready to process "Strava" activities. But unfortunately, due to the limitations imposed by "Strava", it is currently impossible to synchronize activities from this service. Below are a few recommendations on how you can still add activities if you use "Strava". **Activity data export:** you can [download your recorded activities from Strava in GPX or FIT formats](../extracting-activity-files/strava-fit-download.md) and then upload them to us. In this way, each recorded activity needs to be manually processed. You can download an activity from Strava by logging into your Strava account through a computer. On the other hand, you can upload activities to DistantRace in your [profile under "Activities"](https://distantrace.com/en/accounts/my_workouts/). **Use Suunto as an intermediary:** to automatically synchronize your activities with both DistantRace and Strava, you can use the Suunto app to record activities. Record activities with Suunto, which will synchronize them with both Strava and DistantRace. [Learn more](strava-suunto-distantrace.md). **Use Wahoo as an intermediary:** record activities with the Wahoo app and activities will be synchronized with both Strava and DistantRace. [Learn more.](strava-wahoo-distantrace.md) **If you use Apple Health:** download the DistantRace mobile app and you will be able to synchronize your activities from Apple Health. If Strava activities are available in Apple Health, you can also send them to DistantRace. It should be noted, however, that no GPS data will be available for these activities (unless they are recorded with an Apple Watch), which may be required to participate in virtual races and challenges. On our side, we recommend using the Suunto or Wahoo application for activity recording, to automatically synchronize activities with both Strava and DistantRace. This way you can participate in virtual races and challenges organized using DistantRace, and continue to use Strava functionality. --- # Strava + Suunto + DistantRace URL: /en/connections-with-apps/strava-suunto-distantrace/ # Strava + Suunto + DistantRace As we [wrote earlier](strava-and-distantrace-connection.md), Strava does not grant us access to your activities via direct integration. However, you can use Suunto as a solution to automatically synchronize your workouts with both Strava and DistantRace. Here's what you need to do: 1. **Download the Suunto app and create an account** 2. **Connect Suunto to DistantRace:**\ [Read here on how to connect Suunto with DistantRace.](connect-with-suunto.md) 3. **Connect Suunto to Strava:**\ In the Suunto app, go to "Partner services" and find Strava. Press "connect" to link accounts. ![](/static/img/connections-with-apps/strava-suunto-distantrace/image-1711994061409.png) ![](/static/img/connections-with-apps/strava-suunto-distantrace/image-1711994092563.png) 4. **Record your sporting activity:**\ Use the Suunto app or your Suunto watch to record your workouts. Start the activity, and when finished your workout data will automatically be sent to both Strava and DistantRace without any additional actions. This ensures that your workouts are conveniently shared across different platforms, allowing you to participate in challenges and effortlessly track your sports activities. --- # Strava + Wahoo + DistantRace URL: /en/connections-with-apps/strava-wahoo-distantrace/ # Strava + Wahoo + DistantRace As we [wrote earlier](strava-and-distantrace-connection.md), Strava does not grant us access to your activities via direct integration. However, you can use Wahoo as a solution to automatically synchronize your workouts with both Strava and DistantRace. Here's what you need to do: 1. **Download the Wahoo app and create an account.** 2. **Connect Wahoo to DistantRace:**\ [Read here on how to connect Wahoo with DistantRace.](connect-with-wahoo.md) 3. **Connect Wahoo to Strava**:\ Open the Wahoo Fitness app and go to profile settings. Open the "Authorized Apps" section and there you will find Strava in the list. Connect your Strava account with Wahoo. ![](/static/img/connections-with-apps/strava-wahoo-distantrace/image-1712041090236.png) 1. **Record your sporting activity:**\ Use the Wahoo app to record your workouts. 2. **Send activity to Strava**\ Once you have finished your workout, go to the workout information in the Wahoo Fitness app. There you will find the share button - click on it. This action will give you the opportunity to upload your workout to Strava. ![](/static/img/connections-with-apps/strava-wahoo-distantrace/image-1712041307922.png) This ensures that your workouts are conveniently shared across different platforms, allowing you to participate in challenges and effortlessly track your sports activities. --- # Supported Apps URL: /en/connections-with-apps/supported-apps/ # Supported Apps DistantRace allows the connection of leading sports apps. These apps can be connected so that distantrace.com can receive sports activities or daily steps, which are then added to one of the challenges. Here is a table with all supported services: | Service | Daily Steps | Sports Activities | GPS Available for Sports Activities | Sports Activity Recording with Phone | | --- | --- | --- | --- | --- | ![Garmin Connect](/static/img/connections-with-apps/supported-apps/service-garmin.png) [Garmin Connect](connect-with-garmin-connect.md) | ✅︎ | ✅︎ | ✅︎| ❌ | ![service_polar.png](/static/img/connections-with-apps/supported-apps/service-polar.png) [Polar Flow](connect-with-polar-flow.md) | ✅︎ | ✅︎ | ✅︎ | ✅︎ | ![service_suunto.png](/static/img/connections-with-apps/supported-apps/service-suunto.png) [Suunto](connect-with-suunto.md) | ✅︎ | ✅︎ | ✅︎| ✅︎ | ![service_fitbit.png](/static/img/connections-with-apps/supported-apps/service-fitbit.png) [Fitbit](connect-with-fitbit.md) | ✅︎ | ✅︎ | ✅︎| ✅︎ | ![service_uacf.png](/static/img/connections-with-apps/supported-apps/service-uacf.png) [MapMy...](connect-with-under-armour-mapmyrun-mapmywalk-mapmyride-mapmyhike.md) | ❌ | ✅︎ | ✅︎ | ✅︎ | ![service_decathlon.png](/static/img/connections-with-apps/supported-apps/service-decathlon.png) [Decathlon Coach](connect-with-decathlon-coach.md) | ❌ | ✅︎ | ✅︎ | ✅︎ | ![service_health_mate.png](/static/img/connections-with-apps/supported-apps/service-health-mate.png) [Health Mate (Withings)](connect-with-health-mate-withings.md) | ✅︎ | ✅︎ | ❌ | ✅︎ | ![service_wahoo.png](/static/img/connections-with-apps/supported-apps/service-wahoo.png) [Wahoo](connect-with-wahoo.md) | ❌ | ✅︎ | ✅︎ | ✅︎ | ![service_googlefit.png](/static/img/connections-with-apps/supported-apps/service-googlefit.png) [Google Fit](how-to-submit-daily-steps-with-an-android-phone.md#google-fit) | ✅︎ | ❌ | ❌ |❌ | ![service_healthconnect.png](/static/img/connections-with-apps/supported-apps/service-healthconnect.png) [Health Connect](how-to-submit-daily-steps-with-an-android-phone.md#health-connect) | ✅︎ | ❌ | ❌ |❌ | ![service_iphone.png](/static/img/connections-with-apps/supported-apps/service-iphone.png) [Apple Health](how-to-use-apple-health.md) | ✅︎ | ✅︎ | ✅︎|❌ | ![service_samsung.png](/static/img/connections-with-apps/supported-apps/samsung-health.png) [Samsung Health](how-to-submit-steps-with-samsung-health.md) | ✅︎ | ❌ | ❌ |❌ | [Can't find your favorite app?](cant-find-my-favorite-sports-app.md) #### How to choose an activity recording service? We have compiled factors to consider when choosing a sports app to record your sports activities. Remember, you can connect more than one service, so you can test multiple services and choose the one that best meets your capabilities and needs. **Recording activities with a phone:** If you don't have a sports watch and want to record activities with your phone, check if the sports app allows you to do so. For the everyday user, this is the most accessible option, as no additional sports watch is needed for recording activities. **Recording activities with a sports watch:** If you use a sports watch, check if it can connect to the specific brand's sports app. **Recording daily steps with a phone:** If you want to participate in step challenges and you don't have a sports watch, you can do so with your phone. **Recording daily steps with a watch:** If you use a sports watch for daily step counting, check if the specific brand's watch can be connected to DistantRace. **GPS data:** Not all services allow us to receive your activity GPS data (activity route), so we recommend using a service that provides GPS data, as in most challenges, GPS data is a mandatory requirement for activities to be counted in the results. #### How to connect a sports app to your DistantRace account? To synchronize sports activities and participate in virtual challenges and sports competitions, you need to connect a sports app to your DistantRace account. Follow these steps to do it: 1. **Log in to your DistantRace profile** and go to the [homepage](https://distantrace.com/en/accounts/). 2. **Go to "Connections":** On your profile homepage, [find the "Connections" section](https://distantrace.com/en/accounts/social/). In this section, you will have the opportunity to manage all your connections with external services, including connecting and disconnecting sports apps. 3. **Choose the type of connection:** Choose whether you want to connect a sports app or one of the authorization services, such as "Facebook" or "Google". Sports services can be used for sports data synchronization, while authorization services can be used to access your DistantRace account. 4. **Connect the app:** Choose the specific service you want to connect and press the "Connect" button next to the selected service. 5. **Follow further instructions:** After pressing the "Connect" button, you will be redirected to the official website of the selected service. Follow the further instructions on that website. Most likely, you will need to use the email and password of your chosen service account to establish a connection with your DistantRace account, thereby giving permission for DistantRace to receive data from your account in the selected service.\ ❗❗❗**Note:** Some services may ask for permission to access specific data. Carefully check if you have marked all permissions (if any) for us to receive your data. 6. **Return to your DistantRace profile:** After completing the connection process, you will be redirected back to the DistantRace website. From this moment, the connection will be established, and you will be able to synchronize your sports activities with your DistantRace account. It is important to remember that historical activities are not synchronized - the synchronization process starts only after the connections are made. #### How to disconnect a sports app from your DistantRace account? If you no longer wish to have a sports app connected to your distantrace.com account, you can easily disconnect it. To remove app integration, follow these steps: 1. **Open your profile:** Log in to distantrace.com and go to [your profile](https://distantrace.com/en/accounts/). 2. **Go to "Connections":** In your profile, [find the "Connections" section](https://distantrace.com/en/accounts/social/). Here you can manage your integrations with sports and authorization apps. 3. **Find the app you wish to disconnect:** Under the appropriate integration type (sports or authorization apps), find the app you want to disconnect. 4. **Disconnect the service:** Next to the app icon, there is a button named "Disconnect". Click this button. 5. **Confirm the service disconnection:** After clicking the button, you will be directed to a confirmation screen. Confirm your decision to disconnect the app. 6. **The integration is disconnected:** After confirmation, the app integration will be removed from your distantrace.com account. Your sports activity data will no longer be synchronized with this app. With the ability to disconnect apps from distantrace.com, you fully control which apps are connected to your account and can manage your integrations as needed. --- # Daily step challenges URL: /en/daily-step-challenges/ # Daily step challenges Conceptual guides for step-based challenges. **Create and configure** step challenges in [Running events](../running-events/index.md). ## In this section | Guide | What it covers | |-------|----------------| | [Introduction to daily steps](introduction-to-daily-steps.md) | How step counting and daily totals work | | [Create diplomas for participants](how-to-create-diplomas-for-all-participants.md) | Upload a PPTX design and generate finisher diplomas | ## Organizer setup (Running events) | Task | Guide | |------|-------| | Create a step challenge | [Create a step challenge](../running-events/create-a-step-challenge.md) | | Step game daily tasks | [Step game](../running-events/step-game.md) | | Challenge settings | [Challenge settings walkthrough](../running-events/challenge-settings-walkthrough.md) | | Manage participants | [Managing challenge participants](../running-events/managing-challenge-participants.md) | | Export step data | [Exporting step challenge daily results](../running-events/exporting-step-challenge-daily-results.md) | | Share / invite | [Share your event (Easy Access)](../running-events/share-your-event-easy-access.md) | ## Participant guides - [Mobile app and step challenges](../joining-events/mobile-app-and-step-challenges.md) - [Daily steps on the website](../joining-events/daily-steps-on-the-website.md) - [Participate in a challenge](../joining-events/participate-in-a-challenge.md) Legacy `/en/books/daily-step-challenges/` URLs redirect to pages in this section or Running events. --- # How to create diplomas for all participants? URL: /en/daily-step-challenges/how-to-create-diplomas-for-all-participants/ # How to create diplomas for all participants? DistantRace generates **virtual diplomas** for step challenge participants from a **PowerPoint (PPTX) template** you design externally. Placeholder text in the design is replaced with each participant's name, steps, rank, and other challenge data. ::: note Built-in design editor removed The manager no longer includes an in-browser diploma editor. Create your layout in PowerPoint, Google Slides (export as PPTX), or [Canva](../results/race-certificate-creation.md) and upload the `.pptx` file. ::: ## 1. Open the challenge diploma page In the [organizer console](../running-events/access-the-organizer-console.md), open your step challenge and go to **Diploma**. ![](/static/img/results/race-certificate-creation/image-1720337000561-23-08.png) If no template is uploaded yet, the page shows a link to the full design guide. After upload, a **preview image** appears (generation can take up to a minute). ## 2. Create the PPTX design Design the diploma in **PPTX format**. Add placeholder fields as plain text — DistantRace replaces them when generating each participant's diploma. ### Fields for step challenges | Field | Description | |-------|-------------| | `[EVENT NAME]` | Challenge name | | `[PARTICIPANT NAME]` | Participant's full name | | `[Participant Name]` | Full name with each word capitalized | | `[GROUP]` | Participant's standings group | | `[TEAM]` | Team name (if applicable) | | `[FINISH DATE]` | Date of the participant's last synced activity | | `[STEPS]` | Total steps (formatted with thousands separators) | | `[KM]` | Total distance covered | | `[TIME]` | Total active time in the challenge | | `[RANK]` | Overall standing | | `[GRANK]` | Standing within the participant's group | | `[T P]` | Total points | | `[T E]` | Total energy | For design tips, Canva export steps, and sample templates, see [Race certificate creation](../results/race-certificate-creation.md) — the same PPTX workflow and field syntax apply to challenges. ## 3. Upload and publish 1. Click **Browse…**, select your `.pptx` file, and click **Save**. 2. Wait for the preview to appear, then refresh if needed. 3. Check **Is published?** so diplomas generate automatically for participants. 4. When standings are ready, click **Save & Generate** to create or regenerate diplomas for **all challenge participants**. ![](/static/img/results/race-certificate-creation/image-1720353696230-01-26.png) ::: tip Custom fonts If a font in your design renders incorrectly in the preview, email the font file to support@distantrace.com so it can be added to the system. ::: ## 4. Participants download their diploma Once the challenge standings are live and diplomas are generated, participants find their diploma on their result or challenge profile page. See [Downloading diplomas and certificates](../joining-events/downloading-diplomas-and-certificates.md). ## Related - [Diplomas and finisher documents](../results/diplomas-and-finisher-documents.md) — overview for races and challenges - [Race certificate creation](../results/race-certificate-creation.md) — full PPTX design guide with samples - [Managing challenge participants](../running-events/managing-challenge-participants.md) - [Publishing results](../results/publishing-results.md) --- # Introduction to Daily Steps URL: /en/daily-step-challenges/introduction-to-daily-steps/ # Introduction to Daily Steps Daily step challenges are the simplest type of challenge that can be organized, and they are indeed straightforward - the user just needs to install the DistantRace app on their phone, and steps are automatically counted. The step count is not always precise, nor is it known where and how they are taken, but they are automatically recorded on the phone - there's no need to press "start" / "stop" in a sports app. Daily steps can also be counted indoors - no GPS signal is required, which allows participants who cover large distances indoors to participate. We have also prepared informative material about supported applications: [Supported Apps](../connections-with-apps/supported-apps.md). --- # Extracting activity files URL: /en/extracting-activity-files/ # Extracting activity files When automatic sync is unavailable or you need a file backup, export activities from your sports app and [upload manually](../joining-events/managing-your-activities.md). ## By app | App | Format | Guide | |-----|--------|-------| | Strava | FIT | [Strava FIT download](strava-fit-download.md) | | Garmin Connect | GPX | [Garmin GPX download](garmin-gpx-download.md) | | Polar Flow | GPX | [Polar GPX download](polar-gpx-download.md) | | Fitbit | TCX | [Fitbit TCX download](fitbit-tcx-download.md) | | Suunto | FIT | [Suunto FIT download](suunto-fit-download.md) | ## When to use manual files - Your app is not on the [supported apps](../connections-with-apps/supported-apps.md) list - Sync failed and you need a one-off upload — see [Data synchronization troubleshooting](../connections-with-apps/data-synchronization-problems/the-most-common-reasons-for-data-synchronization-issues.md) - Organizer requested proof of an activity ## Related - [Managing your activities](../joining-events/managing-your-activities.md) — upload and submit workouts - [Supported apps](../connections-with-apps/supported-apps.md) — preferred automatic sync - [Why activities are missing](../joining-events/why-activities-are-missing.md) — if uploads do not count --- # Fitbit TCX download URL: /en/extracting-activity-files/fitbit-tcx-download/ # Fitbit TCX download 1. Log into your Fitbit profile from a computer. 2. In the Recent Exercise section, select the activity you wish to add to your DistantRace.com profile. 3. In the upper right corner of the page, choose the "three dots" icon and then press the button Export as TCX File. 4. The selected activity will be downloaded to your computer in TCX format. 5. Then, log into your DistantRace.com profile and go to the My Activities section. 6. Choose the icon "Upload GPX" and add your activity. 7. Once the activity is uploaded, it will automatically be added to your DistantRace.com profile activities. [![Fitbit TCX download](https://img.youtube.com/vi/y8-J5zu2O6g/0.jpg)](https://www.youtube.com/watch?v=y8-J5zu2O6g "Fitbit TCX download") [https://youtu.be/y8-J5zu2O6g](https://youtu.be/y8-J5zu2O6g) --- # Garmin GPX download URL: /en/extracting-activity-files/garmin-gpx-download/ # Garmin GPX download 1. Log into your Garmin Connect account at connect.garmin.com from a computer. 2. Click on the Activities section and then All Activities. 3. Select and open the activity you wish to add to your DistantRace.com profile. 4. In the upper right corner of the page, click on the More icon and choose "Export to GPX". 5. The selected activity will be downloaded to your computer in GPX format. 6. Then, log into your DistantRace.com profile and go to the My Activities section. 7. Choose the "Upload GPX" icon and add your activity. 8. Once the activity is uploaded, it will automatically be added to your DistantRace.com profile activities. [![Garmin GPX download](https://img.youtube.com/vi/AdADziprwA0/0.jpg)](https://www.youtube.com/watch?v=AdADziprwA0 "Garmin GPX download") [https://youtu.be/AdADziprwA0](https://youtu.be/AdADziprwA0) --- # Polar GPX download URL: /en/extracting-activity-files/polar-gpx-download/ # Polar GPX download 1. Log into your Polar Flow account at flow.polar.com from a computer. 2. Click on the Activity section. 3. Select and open the activity you wish to add to your DistantRace.com profile. 4. At the bottom left corner of the page, choose the Export session button and then press the Route (GPX) button. 5. The selected activity will be downloaded to your computer in GPX format. 6. Then, log into your DistantRace.com profile and go to the My Activities section. 7. Choose the "Upload GPX" icon and add your activity. 8. Once the activity is uploaded, it will automatically be added to your DistantRace.com profile activities. [![Polar GPX download](https://img.youtube.com/vi/bZCo_CZFQOQ/0.jpg)](https://www.youtube.com/watch?v=bZCo_CZFQOQ "Polar GPX download") [https://youtu.be/bZCo_CZFQOQ](https://youtu.be/bZCo_CZFQOQ) --- # Strava FIT download URL: /en/extracting-activity-files/strava-fit-download/ # Strava FIT download If you have the Strava app: 1. Log into your Strava profile from a computer. 2. Click on the Training section and then My Activities. 3. Select the activity you wish to add to your DistantRace.com profile. 4. On the left side of the page, click on the "three dots" or Actions icon and choose Export Original. 5. The selected activity will be downloaded to your computer in FIT format. 6. Then, log into your DistantRace.com profile and go to the My Activities section. 7. Choose the "Upload GPX" icon and add your activity. 8. Once the activity is uploaded, it will automatically be added to your DistantRace.com profile activities. [![Strava FIT Download](https://img.youtube.com/vi/sxAw9FlxH3Y/0.jpg)](https://www.youtube.com/watch?v=sxAw9FlxH3Y "Strava FIT Download") --- # Suunto FIT download URL: /en/extracting-activity-files/suunto-fit-download/ # Suunto FIT download 1. Open your Suunto app on your phone. 2. Select and open the activity you wish to add to your DistantRace.com profile. 3. In the upper right corner of the page, choose the "three dots" icon and then press the button Export as FIT File. 4. You can send the selected activity to your email and then upload it from your computer to the DistantRace.com website, or save it on your phone and open the DistantRace.com page directly from your phone. 5. Whether you use a computer or a phone, log into your DistantRace.com profile and go to the My Activities section. 6. Choose the icon "Upload GPX" and add your activity. 7. Once the activity is uploaded, it will automatically be added to your DistantRace.com profile activities. --- # Bulk registration discounts URL: /en/finance-module/bulk-registration-discounts/ # Bulk registration discounts **Bulk discounts** reduce the ticket price automatically when a single checkout includes enough participants. **Path:** Manager console → Finance → **Bulk discounts** ## Create a bulk discount rule 1. Bulk discounts → **Add** 2. Set: - **Minimum participants** — e.g. 5 people in one cart - **Percentage** — discount applied to each eligible ticket - **Status** — published or draft - **Events** — all competitions or selected events 3. Save ## At checkout When a payer registers multiple participants in one order and meets the minimum, the discount applies automatically. Shown in the order summary before payment. ## Per-ticket setting Individual tickets can allow or disallow bulk discount — see [Managing tickets and pricing](../running-events/managing-tickets-and-pricing.md) (**Allow bulk discount**). ## Related - [Discount codes](discount-codes.md) — coupon codes (different mechanism) - [Managing tickets and pricing](../running-events/managing-tickets-and-pricing.md) --- # Creating a payment link URL: /en/finance-module/creating-a-payment-link/ # Creating a payment link Issue a **standalone payment request** when someone owes money outside normal event registration — extra services, late fees, or manual invoices. Payment links create a **cart** in Finance → Orders (same list as registration checkouts). The payer receives an email with a checkout link; when paid, the cart moves to **Payment received** like any other order. **Path:** Manager console → Finance → **Orders** → **Add** In the Finance → Orders section, press **Add**. ![](/static/img/finance-module/creating-a-payment-link/image-1721045187759-06-05.png) A form will open where you can add the information about the required payment. ![](/static/img/finance-module/creating-a-payment-link/image-1721045217684-06-38.png) Field | Description --- | --- Title | What the payment is for — the payer sees this Amount | The total amount payable Buyer Email | The client's email address — the email with the payment request is sent to this address Private Comment | Here you can add a private comment visible only to the organizer. For example, which actions to take after receiving the payment Vat | The VAT amount. Depending on the country, this can contain different values. In Latvia's case, if the payment is for participation, VAT is not applied. If additional products are sold, VAT may apply if the organizer is a VAT payer Language | The language in which the payment request is sent to the client The email the client receives looks like this: ![](/static/img/finance-module/creating-a-payment-link/image-1721045572416-12-31.png) --- # Discount codes URL: /en/finance-module/discount-codes/ # Discount codes The system allows you to define various kinds of coupon codes that can be given to participants so they can register with a discount. Some of the possible scenarios: 1. An email campaign is created where everyone who enters the code "XMAS" gets a 10% discount. 2. 1000 individual codes are prepared that can be sent out / assigned to participants, with each code usable by only 1 participant. 3. Coupon codes are prepared that work once in any of the many events run by the organizer. 4. A coupon code only applies to one specific distance. #### Campaigns All discount codes are grouped into campaigns, so to get a coupon code you first need to create a campaign. ![](/static/img/finance-module/discount-codes/image-1717580808595-46-23.png) Field descriptions: * Name — the campaign name * Status — whether the campaign is available (published = available, unpublished = unavailable). If you set a campaign to "unpublished", none of the campaign codes work anymore. * Start — the date and time when the campaign activates and the coupon codes become valid * End — the date and time when the campaign is no longer active * Max racers — how many participants get a discount with one code. * Max discount — whether the registration with the highest price should be selected and discounted. This applies when the coupon code works for one participant but there are several participants in the cart. Once the basic information is entered and saved, an extended settings window opens, divided into several sections: ![](/static/img/finance-module/discount-codes/image-1717581553825-59-08.png) ##### Campaign competitions Here you need to add the competitions that the added coupon codes will apply to. ![](/static/img/finance-module/discount-codes/image-1717581657628-00-51.png) ##### Campaign distances A coupon code can grant a discount for specific distances, and they can be selected in this section. For each distance, you can set its own discount percentage or discount amount. If you need to add all available competition distances with the same discount amount, choose "Add all distances". ![](/static/img/finance-module/discount-codes/image-1717581812403-03-28.png) ##### Coupon codes This section shows the coupon codes that work in the specific campaign. There can be one or several codes. For example, if an unlimited number of people can register with one discount code, it can be a single code such as `XMAS`. ![](/static/img/finance-module/discount-codes/image-1717581985188-06-21.png) Several functions are available in this section: ###### Add Here you can add one specific coupon code and specify how many times this code may be used. ![](/static/img/finance-module/discount-codes/image-1717582086653-07-49.png) ###### Generate In this section, you can generate coupon codes. Choose how many codes you need, their length, content, and the number of allowed uses. ![](/static/img/finance-module/discount-codes/image-1717582212356-09-51.png) ###### Import If codes were created outside the DistantRace system, they can be imported from a text file. ![](/static/img/finance-module/discount-codes/image-1717582265299-11-01.png) ###### Update All If the coupon code list needs to be refreshed, you can do that here. ![](/static/img/finance-module/discount-codes/image-1717582346298-12-21.png) ###### Reset usage If you want to reset all codes so that all of them are valid again, you can reset their usage. If any code has already been used, it will become usable again. ![](/static/img/finance-module/discount-codes/image-1717582433574-13-49.png) ###### Export XLSX The full list of codes can always be exported to xlsx format. ##### Delete campaign **Delete campaign** removes all **unused** coupon codes (not linked to a cart). If some codes were already redeemed, the campaign is set to **unpublished** instead of deleted — existing orders keep their discount history. ##### All actions In this section, you can see all the actions performed in the specific campaign — who added which competitions/distances and coupon codes. --- # Financial data summary URL: /en/finance-module/financial-data-summary/ # Financial data summary **Fee details** show the DistantRace platform fee and payment processing breakdown for each paid cart. **Path:** Manager console → Finance → **Fee details** (or from competition finance views) ## What you see Each row corresponds to a completed payment: - Gross amount paid by participant - Payment provider fee (Stripe, bank, Montonio, etc.) - DistantRace platform fee (3% with minimum €0.40 on participant-paid events) - Net amount to organizer Use this view to reconcile revenue against [invoices](invoicing.md) and [purchase summaries](purchase-summary.md). ## Export Export fee detail tables to Excel for accounting. ## Related - [Costs and pricing](../running-events/costs-and-pricing.md) - [Invoice summary](invoice-summary.md) --- # Integration with banks URL: /en/finance-module/integration-with-banks/ # Integration with banks Open Banking (via GoCardless Bank Account Data) lets DistantRace **fetch incoming bank transactions** and match them to unpaid invoices — especially useful with [bank transfer](integrations-with-payment-systems.md) payments. **Path:** Manager console → Finance → **Bank accounts** ## Connect a bank account 1. Finance → Bank accounts → **Add account** 2. Select your country and bank from the list 3. You are redirected to your bank's authorization flow 4. After approval, accounts appear in the list DistantRace periodically fetches new transactions. Use **Refresh** on an account to trigger an immediate fetch. ## Match transactions to invoices 1. Finance → **Bank transactions** 2. Review incoming payments 3. Link a transaction to the matching invoice — click **Match invoice** to open the invoice picker popup 4. Mark invoice as paid when amounts match Unmatched or duplicate transactions can be hidden from the default view. ## Remove a connection Delete a bank account from the list. If it was the only account on that connection, the Open Banking link is revoked. ## Permissions Requires **Financial staff** access. ## Related - [Invoicing](invoicing.md) - [Integrations with payment systems](integrations-with-payment-systems.md) --- # Integrations with payment systems URL: /en/finance-module/integrations-with-payment-systems/ # Integrations with payment systems Payment channels let participants pay registration fees and shop products online. **Path:** Manager console → Finance → **Payment channels** ## Available channels | Channel | Region | Notes | |---------|--------|-------| | **Stripe** | International | Connected account onboarding; cards and more | | **Swedbank Latvia BankLink** | Latvia | Bank link + card via EveryPay | | **SEB Latvia** | Latvia | Card payments via Gateway API v4 | | **Klix (Citadele)** | Latvia | Bank link or card — payer chooses | | **Montonio** | Baltics | Multi-bank payment portal | | **Bank transfer** | Any | Manual transfer; pair with [open banking](integration-with-banks.md) | ## Add a payment channel 1. Finance → Payment channels → **Add** 2. Choose the provider card (Stripe, Swedbank, SEB, Klix, Bank transfer) 3. Complete provider-specific setup: - **Stripe** — redirects to Stripe Connect onboarding; return to publish the channel - **Bank links** — enter merchant credentials from your bank 4. Set channel **status** to **Published** when ready Only **published** channels appear at participant checkout. ## Stripe Connect 1. Payment channels → **Connect Stripe** (or Add → Stripe) 2. Complete Stripe onboarding (business details, bank account) 3. Return to DistantRace — channel status updates automatically 4. Re-run onboarding from Payment channels if Stripe requests re-authorization ## Bank transfer Bank transfer lets participants receive an invoice and pay manually. Combine with [open banking](integration-with-banks.md) so incoming payments are matched automatically. ## Per-event tickets Payment channels are club-wide. Enable tickets and prices per competition — see [Managing tickets and pricing](../running-events/managing-tickets-and-pricing.md). ## Refunds Card and Stripe refunds can be initiated from Finance → **Transactions** on supported channels. ## Related - [Invoicing](invoicing.md) - [Costs and pricing](../running-events/costs-and-pricing.md) --- # Introduction to the finance module URL: /en/finance-module/introduction-to-the-finance-module/ # Introduction to the finance module The **Finance** module handles money flowing through your club: participant registration fees, shop products, invoices, and bank reconciliation. **Path:** Manager console → **Finance** Requires **Financial staff** permission (or club admin). ## Main areas | Area | What it does | |------|----------------| | [Payment channels](integrations-with-payment-systems.md) | Stripe, bank links, Montonio, bank transfer | | [Bank integration](integration-with-banks.md) | Open Banking — match incoming transfers to invoices | | [Invoicing](invoicing.md) | View and manage invoices, mark paid, export | | Tickets & pricing | Per-competition — see [Managing tickets and pricing](../running-events/managing-tickets-and-pricing.md) | | [Discount codes](discount-codes.md) | Coupon campaigns | | [Bulk registration discounts](bulk-registration-discounts.md) | Group size discounts | | [Payment links](creating-a-payment-link.md) | One-off payment requests | | [Platform service invoices](invoices-for-platform-services.md) | Invoices when paying DistantRace for slots | | [Orders](../running-events/managing-orders-and-carts.md) | Participant carts and payments | | Summaries | [Purchases](purchase-summary.md), [Invoices](invoice-summary.md), [Fee details](financial-data-summary.md) | | [Refunds](refunds-and-transactions.md) | Card payment refunds | | [Online payment transactions](online-payment-transactions.md) | Stripe, Montonio, gateway payments | | [Managing individual discount codes](managing-individual-discount-codes.md) | Edit single coupon codes | | [Yearly income export](yearly-income-export.md) | Club-wide income XLSX by event and month | ## Participant-paid events When participants pay registration fees, DistantRace charges a **3% platform fee** (minimum €0.40 per transaction) plus payment-provider fees. See [Costs and pricing](../running-events/costs-and-pricing.md). ## Related - [Upsell products in checkout](../running-events/upsell-products-in-checkout.md) - [Integrations](../integrations/introduction-to-integrations.md) — email/SMS (separate from payments) --- # Invoice summary URL: /en/finance-module/invoice-summary/ # Invoice summary The invoice list under Finance is your **invoice summary** — all invoices across events with filters for status, payment method, and date. **Path:** Manager console → Finance → **Invoices** ## Common filters - **Unpaid** — bank transfers awaiting payment - **Paid** — paid invoices - **By event** — revenue for one competition - **By payment channel** — Stripe vs bank link vs transfer ## Bulk export Select date range and export all invoices to Excel for your accounting system. ## Matching bank payments For bank transfer invoices, use [Integration with banks](integration-with-banks.md) to match incoming transactions, or mark invoices paid manually from the detail view. ## Related - [Invoicing](invoicing.md) - [Financial data summary](financial-data-summary.md) --- # Invoices for platform services URL: /en/finance-module/invoices-for-platform-services/ # Invoices for platform services When your **club pays DistantRace** (not participant registration fees), you receive a PDF invoice after checkout. This applies to: - [Upgrading participant limits](../running-events/upgrading-participant-limits.md) — one-time slot purchases - **Pro / Pro+ subscriptions** — monthly participant caps - Other manager-initiated purchases billed to your club ## Checkout flow 1. Open an event → **Upgrade** (or subscription renewal) 2. Select participant count and plan tier 3. Complete checkout — billing uses your **club company details** from club settings 4. Pay by card (Stripe) ## Download the invoice After payment: - Confirmation email includes an **invoice download link** - The invoice PDF is attached to the order in DistantRace's billing system Club admins with financial access can also find related records under Finance (participant-paid orders are separate from these platform charges). ## VAT VAT on platform services is calculated from your club's **country** and **VAT registration** (company VAT ID in club settings). EU clubs with a valid VAT ID may qualify for reverse charge. Ensure club settings include correct: - Company name and registration number - VAT number (if applicable) - Country and address See [Club settings and admins](../running-events/club-settings-and-admins.md). ## Related - [Costs and pricing](../running-events/costs-and-pricing.md) - [Upgrading participant limits](../running-events/upgrading-participant-limits.md) - [Invoicing](invoicing.md) — participant registration invoices (different flow) --- # Invoicing URL: /en/finance-module/invoicing/ # Invoicing Every paid or pending registration creates an **invoice** tied to the participant's cart. **Path:** Manager console → Finance → **Invoices** ## Invoice list Filter by event, payment status, date, or payment method. Each row shows buyer, amount, payment channel, and status. ## Invoice detail Open an invoice to: - View line items (tickets, products, fees) - Download PDF - Change payment date - Apply a manual discount - Mark as paid (for bank transfer or on-site payments) - Link to the originating cart and participant ## Bank transfer workflow 1. Participant selects **bank transfer** at checkout and receives invoice with payment instructions 2. Payment arrives in your bank account 3. [Open banking](integration-with-banks.md) fetches the transaction, or you mark paid manually 4. Participant registration completes ## Export Export invoice lists to Excel from the table actions menu. Large exports are queued and appear under [Documents](../more-tools/organizer-documents.md). ## Related - [Invoice summary](invoice-summary.md) - [Creating a payment link](creating-a-payment-link.md) --- # Managing individual discount codes URL: /en/finance-module/managing-individual-discount-codes/ # Managing individual discount codes While [discount campaigns](discount-codes.md) manage batches of codes, you can edit **individual codes** after generation. **Path:** Manager console → Finance → **Discount codes** ## Code list Filter by campaign, event, or status. Each code shows remaining uses and linked campaign. ## Edit a code Open a code to change: - Usage limit (how many racers can use it) - Status (active/inactive) - Linked events or distances (inherited from campaign unless overridden) ## Usage history View carts that applied the code — useful for fraud checks or partner reconciliation. ## Related - [Discount codes](discount-codes.md) — campaigns - [Bulk registration discounts](bulk-registration-discounts.md) --- # Online payment transactions URL: /en/finance-module/online-payment-transactions/ # Online payment transactions **Bank transactions** (open banking) and **online payment transactions** (Stripe, Montonio, bank links) are separate lists in Finance. **Path:** Manager console → Finance → **Transactions** (online/card) ## What appears Each row is a card or gateway capture: amount, channel, order ID, refund status. ## Refunds Issue refunds on supported channels — see [Refunds and transactions](refunds-and-transactions.md). ## vs bank feed | List | Source | |------|--------| | **Transactions** (this page) | Stripe, Montonio, Swedbank link, etc. | | **Bank transactions** | Incoming transfers on connected bank accounts | Match bank transfers to invoices via [Integration with banks](integration-with-banks.md). ## Related - [Managing orders and carts](../running-events/managing-orders-and-carts.md) - [Financial data summary](financial-data-summary.md) --- # Purchase summary URL: /en/finance-module/purchase-summary/ # Purchase summary View **sold tickets** and registration revenue for a competition. **Path:** Open a competition → **Finance** → Sold tickets (or Tickets → sold summary) ## Filters Filter by ticket, distance, payment status, or date range. ## Export On the sold tickets list, click **Export XLSX** to queue a spreadsheet — useful for bib assignment, start lists, and accounting. Exports appear in [Documents](../more-tools/organizer-documents.md) when ready. Scanned ticket status (used vs unused) appears after [mobile ticket scanning](../running-events/mobile-ticket-scanning-for-organizers.md). ## Related - [Managing tickets and pricing](../running-events/managing-tickets-and-pricing.md) - [Invoicing](invoicing.md) --- # Refunds and transactions URL: /en/finance-module/refunds-and-transactions/ # Refunds and transactions **Transactions** lists card and online payments processed through your payment channels. **Path:** Manager console → Finance → **Transactions** ## Transaction list Each row shows order ID, amount, payment channel (Stripe, Montonio, bank link), and status. Filter by date or channel for reconciliation against [fee details](financial-data-summary.md). ## Issue a refund On supported channels (Stripe, some bank links): 1. Open the transaction or use the refund action from the list 2. Enter refund amount (partial or full) 3. Confirm — funds return via the original payment method Refunds update the linked cart and may affect participant registration status — review the order after refunding. ## Bank transfer limitations Bank transfer / prepay invoice payments are not refunded through the payment gateway. Handle manually via bank transfer back to the participant and adjust invoice status. ## Related - [Managing orders and carts](../running-events/managing-orders-and-carts.md) - [Integrations with payment systems](integrations-with-payment-systems.md) --- # Yearly income export URL: /en/finance-module/yearly-income-export/ # Yearly income export Export a club-wide **income spreadsheet** — entry fees and shop products broken down by event, year, month, and payment channel. **Path:** Manager console → **Competitions** list → **Export Income XLSX** Requires club staff with **Support team** access or higher (any role that can open the Competitions list). ## What the file contains The spreadsheet (`total_income.xlsx`) has one worksheet with **grouped rows per event**: | Row type | Columns filled | |----------|----------------| | **Event total** (collapsible group header) | Event ID, name, combined entry fees, products, DistantRace fees, reversed/refunded totals | | **Monthly sub-rows** | Payment year, payment month, entry/products/total for that month | Base columns on every row: | Column | Data | |--------|------| | ID | Event ID | | Event | Primary event name | | Payment Year / Month | Blank on the total row; filled on monthly breakdown rows | | Total Entry Fees | Sum of ticket line items | | Total Products | Sum of shop add-ons | | Total (Entry Fees + Products) | Combined revenue | | Total DistantRace Fees | Platform fees for the event | | Total Reversed | Refunded/chargeback amounts (negative) | For each [payment channel](integrations-with-payment-systems.md) your club has used, three extra columns appear: **Entry**, **Products**, and **Total** for that channel. **Montonio** channels add two sub-columns — `cardPayments` and `paymentInitiation` — split from gateway transaction metadata. Monthly rows only include carts with **payment received** status and at least one **OK** transaction timestamp. ## When to use - Annual accounting and tax reporting - Reconcile against [Purchase summary](purchase-summary.md) and [Online payment transactions](online-payment-transactions.md) - Compare revenue across seasons and payment methods ## Download 1. Open the **Competitions** list at club level (not inside one event). The list defaults to the current calendar year — adjust filters if you need other seasons. 2. Click **Export Income XLSX** in the page actions. 3. Wait for background processing — the file appears in [Organizer documents](../more-tools/organizer-documents.md) as **Total Income**. ::: note Competition-level exports Per-event income charts and distance breakdowns are on the [Competition dashboard analytics](../running-events/competition-dashboard-analytics.md), not this export. ::: ## Related - [Financial data summary](financial-data-summary.md) - [Club billing from DistantRace](../running-events/club-billing-from-distantrace.md) --- # What is DistantRace? URL: /en/general-information/what-is-distantrace/ # What is DistantRace? DistantRace is a platform for creating and joining sports events — from corporate step challenges to in-person races with online registration. ## Event types | Type | For participants | For organizers | |------|------------------|----------------| | **Step challenges** | Daily steps sync automatically | [Create a step challenge](../running-events/create-a-step-challenge.md) | | **Sports activity challenges** | Record workouts in sports apps | [Create a sports activity challenge](../running-events/create-a-sports-activity-challenge.md) | | **Virtual competitions** | One GPS-timed effort over a set distance | [Create a virtual competition](../running-events/create-a-virtual-competition.md) | | **In-person races** | Ticket registration and payment | [Create an in-person race](../running-events/create-an-in-person-race.md) | ## Get started **Participants:** [Joining events](../joining-events/index.md) **Organizers:** [Running events](../running-events/index.md) ## Connections DistantRace integrates with Garmin, Polar, Fitbit, Apple Health, and many other apps. See [Supported apps](../connections-with-apps/supported-apps.md). ## In-person race services Organizers can run registration, payments, start lists, timing import, diplomas, and participant messaging on one platform. See the [finance module](../finance-module/introduction-to-the-finance-module.md) and [running events](../running-events/index.md) section. --- # Why create challenges on the DistantRace platform? URL: /en/general-information/why-create-challenges-on-the-distantracecom-platform/ # Why create challenges on the DistantRace platform? If you are an event organizer or just want to create sports challenges for your colleagues or friends, then you have come to the right place. We offer many and varied options: - **Virtual Club**: If you create challenges on distantrace.com, it all starts with creating a virtual club, and all participants who join your organized events automatically join your club, which further provides simple communication with participants, for example, informing about upcoming challenges. Each club has its own homepage on the distantrace.com platform, where you can get acquainted with all the club's organized events, offering participants easy access to all events and registration. In addition, the club page can include news, announcements, etc., related to club activities. It is also possible to sell club merchandise, such as t-shirts, medals, and other items, creating a sense of community among members. - **Easily Create Events**: Creating virtual challenges and competitions on distantrace.com is very simple. Just add an event name, some registration parameters, and rules. - **Public On-site Events**: For on-site events with a common start time, such as marathons, distantrace.com provides a simple registration platform and result processing. - **Participant Management**: Organizing a participant database is quite simple. On the distantrace.com platform, you can follow registrations, purchases, and bank transactions. In addition, participants themselves have the option to change the distance or purchase additional products. - **Results Processing and Rankings**: distantrace.com provides result processing and automatically calculates rankings, making the organizer's job easier. - **International Solution**: Reach your participants anywhere in the world, making the sports event accessible to a diverse audience. - **Community Building**: Using distantrace.com, it is possible to create a sense of community among participants, providing the opportunity to communicate with each other, share experiences, and celebrate achievements. [**Click here to create a new event.**](https://distantrace.com/en/console/?create_event=1) --- # Why participate in competitions using DistantRace? URL: /en/general-information/why-participate-in-competitions-using-distantracecom/ # Why participate in competitions using DistantRace? Participating in virtual challenges and mass competitions using DistantRace provides participants with a series of convincing advantages. Whether you're a passionate sports enthusiast or just a beginner, here are some reasons to consider using the platform: - **Accessibility**: DistantRace allows participants to engage in challenges on their own schedule and at their chosen location. - **Motivation**: Joining virtual challenges adds an extra level of motivation to training. Setting goals, tracking progress, and competing with others can increase participants' commitment to achieving their goals. - **Global Community**: DistantRace connects participants with a diverse community of like-minded people from around the world. Engage in friendly competition, share achievements, and offer support to other participants, fostering a sense of camaraderie. - **Versatile Challenge Options**: By utilizing various virtual challenges, you can find exactly what matches each participant's individual interests and readiness level. - **Goal Achievement**: Participating in virtual challenges provides a tangible sense of accomplishment. Crossing the finish line, even in a virtual space, can be incredibly inspiring and can enhance each participant's confidence. Public competitions and challenges are available here: . --- # How to use DistantRace URL: /en/how-to-use-distantrace/ # How to use DistantRace Participant how-to guides from the old BookStack section now live under **[Joining events](../joining-events/index.md)**. URLs under `/en/how-to-use-distantrace/` redirect automatically. ## Start here | Topic | New location | |-------|--------------| | Create an account | [Create an account](../joining-events/create-an-account.md) | | Find events in the app | [Find an event in the app](../joining-events/find-an-event-in-the-app.md) | | Join a challenge | [Participate in a challenge](../joining-events/participate-in-a-challenge.md) | | Join a virtual competition | [Participate in virtual competitions](../joining-events/participate-in-virtual-competitions.md) | | Withdraw from an event | [Withdraw from an event](../joining-events/withdraw-from-an-event.md) | | Missing activities | [Why activities are missing](../joining-events/why-activities-are-missing.md) | | Children under 13 | [Age restrictions and children](../joining-events/age-restrictions-and-children.md) | ## Related sections - [Joining events](../joining-events/index.md) — full participant guide - [Connections with apps](../connections-with-apps/intro.md) — sync sports apps and steps - [Mobile app](../mobile-app/index.md) — install, QR join, settings --- # Bannerbear URL: /en/integrations/bannerbear/ # Bannerbear ::: note Not implemented Bannerbear integration is not available. Use DistantRace **race certificates** instead. ::: See [Race certificate creation](../results/race-certificate-creation.md) for PowerPoint-based diploma templates with automatic field replacement. --- # Email templates and export URL: /en/integrations/email-templates-and-export/ # Email templates and export The **Marketing** module lets you customize emails participants receive and export contact lists for external tools. **Path:** Manager console → **Marketing** → Email templates Requires a connected email provider: [SendGrid](sendgrid.md) or [Listmonk](listmonk.md). ## Template kinds | Kind | When sent | |------|-----------| | **Marketing** | Campaign emails you trigger manually | | **Registration** | After successful registration | | **Registration cart** | Cart / checkout confirmation | | **Registration participant** | Per-participant registration details | | **Result** | When results are published (if configured) | | **Join code** | Join code invitation emails | | **Login code** | App login verification codes | ## Create a template 1. Marketing → Email templates → **Create template** 2. Choose **kind**, **language**, subject, and HTML body 3. Use template variables (participant name, event name, join link, etc.) — **Preview** on the edit page shows rendered HTML with sample data 4. Optional: **Add registration QR codes** for join-code templates 5. **Send test** to your email before going live ## Per-event templates Templates can be scoped to a specific event or used club-wide. Event-specific templates override defaults for that event. ## Export participants Marketing → **Export** lets you download participant emails and fields for use in Listmonk, Omnisend, or spreadsheets. Filter by event, registration status, or marketing consent. ## Related - [Marketing to participants](../running-events/marketing-to-participants.md) - [Marketing preferences on registration](../running-events/marketing-preferences-on-registration.md) - [SendGrid](sendgrid.md) --- # Generatebanners URL: /en/integrations/generatebanners/ # Generatebanners ::: note Not implemented Generatebanners integration is not available in DistantRace. ::: For finisher certificates, see [Race certificate creation](../results/race-certificate-creation.md). --- # Introduction to integrations URL: /en/integrations/introduction-to-integrations/ # Introduction to integrations Integrations connect your DistantRace **club** to external services for email, SMS, contact sync, and parcel shipping. **Path:** Manager console → Club settings → **Integrations** Integrations are separate from **payment channels** (Stripe, bank transfer, etc.) — those live under [Finance](../finance-module/introduction-to-the-finance-module.md). ## Available integrations | Integration | Purpose | Guide | |-------------|---------|-------| | **SendGrid** | Transactional email from your domain | [SendGrid](sendgrid.md) | | **Listmonk** | Self-hosted mailing lists + purchase emails | [Listmonk](listmonk.md) | | **Omnisend** | Marketing automation + order sync | [Omnisend](omnisend.md) | | **Twilio** | SMS and WhatsApp messaging | [Twilio](twilio.md) | | **Text2Reach** | Latvian SMS gateway (primary or backup) | [Text2Reach](text2reach.md) | | **SMS Server Tools** | Self-hosted SMS API (primary or backup) | [SMS Server Tools](sms-server-tools.md) | | **Omniva shipping** | Parcel labels for checkout add-ons | [Omniva shipping](omniva-shipping.md) | ## Marketing module (uses integrations) After connecting email or messaging providers, use **Marketing** in the manager console: - [Email templates and export](email-templates-and-export.md) - [SMS campaigns](sms-campaigns.md) - [WhatsApp campaigns](whatsapp-campaigns.md) - [WhatsApp template management](whatsapp-template-management.md) - [Marketing to participants](../running-events/marketing-to-participants.md) ## SMS provider priority You can connect **multiple SMS providers** (Twilio, Text2Reach, SMS Server Tools). Set each as **primary** or **backup**. DistantRace tries the primary provider first and falls back if sending fails. ## Not available These pages exist for legacy reasons but are **not connectable** in the current product: - [Mailchimp](mailchimp.md) — removed from product - [MailerLite](mailerlite.md) — never implemented - [Bannerbear](bannerbear.md) — use [race certificates](../results/race-certificate-creation.md) instead - [Generatebanners](generatebanners.md) — not implemented ## Related - [Embed domains](../running-events/embed-domains-for-iframes.md) — DNS verification for iframe embedding (club settings) - [Partner registration](../running-events/partner-and-corporate-registration.md) --- # Listmonk URL: /en/integrations/listmonk/ # Listmonk [Listmonk](https://listmonk.app/) is a self-hosted newsletter and mailing list manager that organizers can use in-house to send out informational emails to participants. Listmonk can be self-installed on your own server, or it can be quickly and easily set up in the cloud. Here are some clouds where you can quickly set up the Listmonk system:
| Cloud services | | :-: | | [![One-click deploy on Railway](https://camo.githubusercontent.com/d07713342bc583232f8752c33a6a24e5f367d73725183a63f2f5fdd7c00606a3/68747470733a2f2f7261696c7761792e6170702f627574746f6e2e737667)](https://railway.app/new/template/listmonk) | | [![Deploy on Elestio](https://github.com/elestio-examples/wordpress/raw/main/deploy-on-elestio.png)](https://dash.elest.io/deploy?soft=Listmonk&id=237) | | [![Deploy on PikaPod](https://www.pikapods.com/static/run-button.svg)](https://www.pikapods.com/pods?run=listmonk) |
The Listmonk dashboard looks like this: [![splash.png](https://listmonk.app/static/images/splash.png)](https://listmonk.app/static/images/splash.png) To connect Listmonk, go to Club settings -> "Integrations". Club settings can be found in the bottom left corner. ![](/static/img/integrations/listmonk/image-1715233033231-34-49.png) Under integrations, find Listmonk and click "Connect". ![](/static/img/integrations/listmonk/image-1715233117621-37-25.png) To connect Listmonk, the following fields must be filled out: ![](/static/img/integrations/listmonk/image-1715233169267-38-53.png) After filling out the fields and pressing "Save," the system will attempt to connect to Listmonk and verify that the connection is working. Once the connection is established, you can choose an email design, and perform the following actions: 1. Choose the email design that is sent when a membership is successfully paid for. 2. Perform event synchronization. 3. Synchronize member emails. 4. Send a test "Purchase email". #### Event synchronization (competitions or challenges) Every organizer's event creates a new email list in Listmonk, allowing participants to be linked to a specific email list so that the organizer can send emails only to participants of that specific event. By pressing the "Initialize Full Event Sync" button, all events are created in Listmonk. All events will be saved in the following format: "Year - Competition Name". When adding a new participant to Listmonk, the system checks if the specific event has been created; if not, it is created. #### Participant synchronization Each time a purchase is made (membership payment), a request is sent to Listmonk and the participants' emails are added. Both the "billing email," which the buyer must fill out, and all emails attached to the participants are added. Each participant is added to the specific competition list and the following attributes are attached: ![](/static/img/integrations/listmonk/image-1715234635829-03-44.png) * Events - contains a list of all the events in which the participant has participated. * Marketing - contains information about the "marketing" preferences marked during the purchase step. This information can be used to filter participants and add them to new mailing lists. For example, to find all participants who have indicated that they wish to receive news, the following query can be used: `(subscribers.attribs->'marketing'->>'News')::BOOLEAN = true`. ![](/static/img/integrations/listmonk/image-1715234734703-05-26.png) Executing this query will select all participants who have indicated that they wish to receive news. #### Initial participant synchronization To perform the initial participant synchronization, you must press the "Initialize Full data sync with Listmonk" button. Note that this may take longer if the number of participants is large. #### Purchase confirmation email DistantRace sends an automatic email from the system when a participant pays for their entry, but organizers can create their own email design. It is important to include the following in the email: * What is being paid for and the amounts * The total amount paid * A link to the purchase confirmation How to create an email and connect it to DistantRace? 1. Create a purchase confirmation email. In Listmonk, it is possible to create "Transactional" email designs. Create a new design for purchase confirmation. ![](/static/img/integrations/listmonk/image-1715235145934-11-18.png) Here is a simplified sample for the email: ```
 

Hello {{ .Subscriber.Name }}

Order number: {{ .Tx.Data.orderNumber }}
Created date: {{ .Tx.Data.createdAt }}


{{range .Tx.Data.products}} {{end}}
NamePrice
{{.title }}{{.price}} {{ .Tx.Data.currency }}
Total price: {{ .Tx.Data.orderSum }} {{ .Tx.Data.currency }}

Open Order

{{ L.T "public.poweredBy" }} listmonk

``` Visually, this HTML looks like this: ![](/static/img/integrations/listmonk/image-1715235241196-13-48.png) 2. Once the design is prepared, the specific template must be selected in the DistantRace Listmonk integration: ![](/static/img/integrations/listmonk/image-1715235304204-14-55.png) If the design is not available, press the "Update" button (pressing this button refreshes the list of designs) and reopen the integration. 3. Once the design is selected and saved, you can test how the design looks by sending a test email. Press the button "Test Order Email (if template is set)". That's it - from this moment on, if a participant pays for their entry, only your designed email will be sent. Here is a sample with the information that is sent to Listmonk to send the email: ``` { "subscriber_email": email, "template_id": template_id, "data": { "orderID": "36902", "orderNumber": 36902, "firstName": first_name, "lastName": last_name, "cartID": "36902", "orderUrl": "https://distantrace.com/en/cart/d5949dac-b7d9-4e93-a874-34946286c006/", "currency": "EUR", "orderSum": 30.0, "createdAt": "2024-05-02 15:50", "updatedAt": "2024-05-02 16:36", "paymentMethod": "payment with card", "paymentStatus": "paid", "tags": ["Competition Name"], "products": [ { "cartProductID": 85268, "productID": "607", "variantID": "432", "variantTitle": "Distance Name", "title": "Participant Name - Competition Name, Distance Name, Additional products", "vendor": "Competition Name", "quantity": 1, "price": 15.0, }, { "cartProductID": 85268, "productID": "607", "variantID": "432", "variantTitle": "Distance Name", "title": "Participant Name - Competition Name, Distance Name, Additional products", "vendor": "Competition Name", "quantity": 1, "price": 15.0, }, ], }, "content_type": "html", } ``` --- # Mailchimp URL: /en/integrations/mailchimp/ # Mailchimp ::: warning No longer available Mailchimp integration was removed from DistantRace. Use one of these alternatives instead: ::: - [Listmonk](listmonk.md) — self-hosted mailing lists - [Omnisend](omnisend.md) — marketing automation - [SendGrid](sendgrid.md) — transactional email from your domain See [Introduction to integrations](introduction-to-integrations.md). --- # MailerLite URL: /en/integrations/mailerlite/ # MailerLite ::: note Not implemented MailerLite integration is not available in DistantRace. ::: Use [Listmonk](listmonk.md), [Omnisend](omnisend.md), or [SendGrid](sendgrid.md) instead. --- # Omnisend URL: /en/integrations/omnisend/ # Omnisend [Omnisend](https://www.omnisend.com/) is a marketing automation platform. DistantRace syncs participants and orders so you can run email campaigns in Omnisend. ## Connect Omnisend 1. In Omnisend, get your **API key** and **Brand ID** (account ID). 2. In DistantRace: Club settings → **Integrations** → Omnisend → **Connect**. 3. Enter **Account ID** and **API key**. 4. Optional settings after save: - **Use order confirmation** — send Omnisend order-confirmation emails on paid registration - **Marketing preference mapping** — map a registration marketing question to Omnisend subscribe status ## Sync actions After connecting, use the integration panel to: - **Initialize full event sync** — create Omnisend lists for your events - **Sync member emails** — push participant contacts - **Send test purchase email** — verify order confirmation template Each event creates a list named `Year - Event Name` in Omnisend. ## Marketing preferences If your registration form includes a marketing consent question, map it in Omnisend settings so only opted-in participants are subscribed. See [Marketing preferences on registration](../running-events/marketing-preferences-on-registration.md). ## Related - [Listmonk](listmonk.md) — self-hosted alternative - [Email templates and export](email-templates-and-export.md) --- # Omniva shipping URL: /en/integrations/omniva-shipping/ # Omniva shipping Connect **Omniva** to generate parcel shipments when participants buy physical products (medals, t-shirts, etc.) with Omniva delivery at checkout or afterward. ## Connect Omniva 1. Get Omniva **API username** and **password** from your Omniva business account. 2. Club settings → **Integrations** → **Shipping – Omniva** → **Connect**. 3. Enter credentials and save. DistantRace validates the integration before label generation runs. ## Shop products Create products in the shop module with the **Omniva** product class (`SHIPPING_OMNIVA`). Participants select a parcel terminal at checkout; phone and terminal ZIP are stored on the cart as `shipping_data`. See [Upsell products in checkout](../running-events/upsell-products-in-checkout.md). At checkout the terminal list comes from Omniva's public location API. The same picker is used on the post-checkout page. ## Post-checkout quick add If a participant paid without choosing delivery, send them: `/shop/quick/add_omniva/?c=` The page lists order participants, then collects phone + parcel machine. See [Adding Omniva shipping after checkout](../joining-events/adding-omniva-shipping-after-checkout.md). Organizers can include this URL in manual emails or campaigns when fulfillment happens after the event. ## Integration actions After connecting, the Omniva integration panel offers: | Action | Purpose | |--------|---------| | **Generate shipments** | Create Omniva API shipments for paid orders missing labels (per event) | | **Import/export CSV** | Export or import shipment data for bulk Omniva portal workflows | Generation runs as a background task — see [Managing Omniva shipments](../running-events/managing-omniva-shipments.md). ## Manage shipments After orders are placed: 1. Open the competition → **Shipping** 2. Review carts, tracking codes, and status 3. Generate labels or export shipment data 4. Mark progress as Omniva tracking events arrive (shipped emails send automatically) ## Related - [Create an in-person race](../running-events/create-an-in-person-race.md) - [Checkout add-ons](../joining-events/checkout-add-ons-and-shipping.md) (participant view) - [Managing Omniva shipments](../running-events/managing-omniva-shipments.md) --- # SendGrid URL: /en/integrations/sendgrid/ # SendGrid SendGrid lets your club send **transactional email** (registration confirmations, join codes, login codes) from your own verified sender address instead of the default DistantRace sender. ## Connect SendGrid 1. Create a [SendGrid](https://sendgrid.com/) account and verify your **sender domain** or single sender email. 2. Create an API key with **Mail Send** permission. 3. In DistantRace: Club settings → **Integrations** → SendGrid → **Connect**. 4. Enter: - **SendGrid API key** - **From email** — must be verified in SendGrid - **From name** — display name (e.g. your event brand) 5. Save — DistantRace validates the key against the SendGrid API. ## What uses SendGrid When connected and valid, SendGrid sends: - [Email templates](email-templates-and-export.md) (registration, results, join codes, marketing) - Join code invitation emails - Login code emails Configure templates under **Marketing → Email templates**. ## Troubleshooting | Error | Fix | |-------|-----| | API key rejected | Check key permissions include Mail Send | | From email not verified | Complete sender verification in SendGrid | | Emails not arriving | Check SendGrid activity log and spam filters | ## Related - [Email templates and export](email-templates-and-export.md) - [Listmonk](listmonk.md) — alternative for list-based marketing email --- # SMS campaigns URL: /en/integrations/sms-campaigns/ # SMS campaigns Send bulk or targeted SMS to participants after connecting an SMS provider. **Path:** Manager console → **Marketing** → SMS campaigns ## Prerequisites Connect at least one SMS integration: - [Twilio](twilio.md) - [Text2Reach](text2reach.md) - [SMS Server Tools](sms-server-tools.md) Set one provider as **primary**; others can be backup. ## Create a campaign 1. Marketing → SMS campaigns → **Create** 2. Select target event and audience (all participants, distance, status filter) 3. Use **Preview recipients** on the form — shows how many people match before you send (updates when filters change) 4. Write message text — keep under 160 characters for single-segment SMS where possible 5. Schedule or send immediately 6. Review delivery status in the campaign detail view ## Campaign status On the campaign detail page: - **Disable** — pause a scheduled campaign without deleting it - **Enable** — re-activate a disabled campaign - **Delete** — remove campaigns that have not sent messages yet View individual message delivery under **Marketing → Messages**. ## SMS templates Reusable templates live under Marketing → **SMS templates**. Use them for recurring messages (race-day reminders, result notifications). See [SMS templates and message log](sms-templates-and-message-log.md). ## Costs SMS is billed by your provider (Twilio, Text2Reach credits, etc.). DistantRace does not add a per-SMS markup. ## Related - [WhatsApp campaigns](whatsapp-campaigns.md) - [Marketing to participants](../running-events/marketing-to-participants.md) --- # SMS Server Tools URL: /en/integrations/sms-server-tools/ # SMS Server Tools **DistantRace SMS Server Tools** integration connects a self-hosted SMS gateway compatible with the SMS Server Tools API. Use it as **primary or backup** alongside Twilio or Text2Reach. ## Connect 1. Deploy your SMS Server Tools instance (or use DistantRace-hosted tools if provided). 2. Club settings → **Integrations** → **SMS Server Tools** → **Connect**. 3. Enter the server **URL**, credentials, and **Primary/Backup** priority. 4. Save and verify the connection test passes. ## What uses it - [SMS campaigns](sms-campaigns.md) - Fallback SMS delivery when the primary provider fails ## Related - [Text2Reach](text2reach.md) - [Twilio](twilio.md) - [SMS campaigns](sms-campaigns.md) --- # SMS templates and message log URL: /en/integrations/sms-templates-and-message-log/ # SMS templates and message log Manage reusable SMS content and audit past sends. **Path:** Manager console → Marketing ## SMS templates **Marketing → SMS templates** Create templates with placeholders (participant name, event title, links). Use when building [SMS campaigns](sms-campaigns.md). Templates must fit single-segment length where possible (160 GSM characters) to avoid multi-part billing. ## Message log **Marketing → Messages** (`/marketing/messages/`) Lists individual SMS messages sent through DistantRace: - Delivery status - Recipient phone - Linked campaign - Timestamp and provider (Twilio, Text2Reach, etc.) Use the log to troubleshoot failed sends or prove delivery. ## Prerequisites Connect at least one SMS provider — see [Introduction to integrations](introduction-to-integrations.md). ## Related - [SMS campaigns](sms-campaigns.md) - [Text2Reach](text2reach.md) - [Twilio](twilio.md) --- # Text2Reach URL: /en/integrations/text2reach/ # Text2Reach [Text2Reach](https://www.text2reach.com/) is a Latvian SMS gateway. Use it as a **primary or backup** SMS provider alongside Twilio or SMS Server Tools. ## Connect Text2Reach 1. Get your Text2Reach **API key** and configure a **sender name**. 2. Club settings → **Integrations** → Text2Reach → **Connect**. 3. Enter API key, sender name, and choose **Primary** or **Backup** provider. 4. Save — DistantRace validates the key and shows your SMS credit balance. ## What uses Text2Reach - [SMS campaigns](sms-campaigns.md) in the Marketing module - System SMS when Twilio is not primary or fails ## Provider priority If you also connect Twilio or SMS Server Tools, only one should be **primary**. Others act as backup. See [Introduction to integrations](introduction-to-integrations.md). ## Related - [SMS campaigns](sms-campaigns.md) - [Twilio](twilio.md) --- # Twilio URL: /en/integrations/twilio/ # Twilio Connect Twilio to send **SMS** and **WhatsApp** messages to participants via the Marketing module. ## Connect in DistantRace 1. Club settings → **Integrations** → Twilio → **Connect** 2. Enter: - **Account SID** and **Auth token** (from [Twilio Console](https://console.twilio.com/)) - Enable **SMS** and/or **WhatsApp** - **WhatsApp phone number** — your approved WhatsApp sender - **Messaging service SID** — for SMS delivery 3. Save — DistantRace validates credentials against the Twilio Content API. After connecting: - [SMS campaigns](sms-campaigns.md) - [WhatsApp campaigns](whatsapp-campaigns.md) ## WhatsApp setup (Twilio + Meta) What needs to be done to set up WhatsApp: 1. Create a Facebook Business account: https://business.facebook.com 2. Register on twilio.com and log in to the system. 3. In the menu, go to "Messaging - Senders - WhatsApp senders" ![](/static/img/integrations/twilio/image-1713444557323-18-10.png) 4. Add a phone number or buy a number from Twilio: To connect WhatsApp, the Twilio account must have a credit card attached and a $20 advance deposited into the account. ![](/static/img/integrations/twilio/image-1713444587939-18-49.png) ![](/static/img/integrations/twilio/image-1713444594768-19-37.png) ![](/static/img/integrations/twilio/image-1713444600931-19-43.png) ![](/static/img/integrations/twilio/image-1713444609322-27-41.png) ![](/static/img/integrations/twilio/image-1713444616946-27-47.png) ![](/static/img/integrations/twilio/image-1713444621675-28-39.png) ![](/static/img/integrations/twilio/image-1713444627972-30-19.png) ![](/static/img/integrations/twilio/image-1713444631855-30-45.png) 5. Go to "Services" and add WhatsApp as a sending channel: ![](/static/img/integrations/twilio/image-1713444937732-36-52.png) ![](/static/img/integrations/twilio/image-1713444945004-37-10.png) ![](/static/img/integrations/twilio/image-1713444951353-37-16.png) ![](/static/img/integrations/twilio/image-1713444968305-37-22.png) ![](/static/img/integrations/twilio/image-1713444975382-37-34.png) 6. Go to Facebook, to "WhatsApp accounts": ![](/static/img/integrations/twilio/image-1713444739556-27-16.png) 7. Go to "settings" and press "Start verification". ![](/static/img/integrations/twilio/image-1713444818251-31-37.png) ![](/static/img/integrations/twilio/image-1713444830978-31-53.png) ![](/static/img/integrations/twilio/image-1713444841122-34-53.png) ![](/static/img/integrations/twilio/image-1713444852348-34-59.png) 8. Create the design of the outgoing WhatsApp message in Twilio: https://console.twilio.com/us1/develop/sms/content-template-builder. ![](/static/img/integrations/twilio/image-1713445083359-38-18.png) ![](/static/img/integrations/twilio/image-1713445092252-38-25.png) ![](/static/img/integrations/twilio/image-1713445100484-40-27.png) 9. Send the created message design to Facebook for approval. If the outgoing WhatsApp message is a results message, choose "Utility", because this type of WhatsApp message has a cheaper price. It is recommended not to allow WhatsApp to move it to another category on its own, because results WhatsApp messages are very often moved to the Marketing category, where the price of each message is much higher. ![](/static/img/integrations/twilio/image-1713445139860-40-47.png) ![](/static/img/integrations/twilio/image-1713445172595-40-53.png) ![](/static/img/integrations/twilio/image-1713445207044-41-43.png) If WhatsApp rejects the WhatsApp message with a statement that it does not fit the Utility category, you need to submit an "appeal" to Facebook. Example of an appeal comment: This message is intended for marathon participants who cross the finish line. We categorize it as an "order update" message, since in our context, "registration for a competition" is analogous to placing an order. Contents of the message: 1. Participant Name 2. Participant Distance (e.g., Marathon/Half-Marathon) 3. Time 4. Overall Place 5. Participant's Age Group 6. Participant's Place in Age Group 7. Standing Result 8. "Show Result" button that directs the user to his or her result certificate. This message contains no marketing content; it merely updates the order status to "Finished Marathon" and includes the certificate in the dynamic link. 10. Enter your Twilio credentials in DistantRace (Club settings → Integrations → Twilio): https://console.twilio.com/ ![](/static/img/integrations/twilio/image-1713445603770-06-19.png) --- # WhatsApp campaigns URL: /en/integrations/whatsapp-campaigns/ # WhatsApp campaigns Send WhatsApp messages to participants using **Twilio** as the messaging provider. **Path:** Manager console → **Marketing** → WhatsApp ## Prerequisites 1. Connect [Twilio](twilio.md) with WhatsApp enabled 2. Complete Meta Business verification and WhatsApp sender setup (see Twilio guide) 3. Create and approve **WhatsApp message templates** in Twilio / Meta — WhatsApp requires pre-approved templates for outbound messages ## Send messages 1. Marketing → WhatsApp → **Create campaign** 2. Select an approved template and target event 3. Filter audience (registration status, distance, region on map-based campaigns) 4. Use **Preview recipients** on the create form — count and sample rows update as filters change 5. Fill template variables (participant name, event date, etc.) 6. Send or schedule ## Campaign status On the campaign detail page you can: - **Disable** — stop a scheduled or recurring campaign without deleting history - **Enable** — re-activate a disabled campaign - **Delete** — remove a campaign that has not yet sent messages (sent campaigns cannot be deleted) Track delivery in **Marketing → WhatsApp → Messages**. ## Template approval New WhatsApp templates must be submitted to Meta for approval before use. Allow 24–48 hours for review. ## Related - [Twilio](twilio.md) — Meta Business and WhatsApp sender setup - [SMS campaigns](sms-campaigns.md) --- # WhatsApp template management URL: /en/integrations/whatsapp-template-management/ # WhatsApp template management WhatsApp requires **pre-approved message templates** before you can send outbound messages. Manage templates in the manager console after connecting [Twilio](twilio.md). **Path:** Manager console → Marketing → **WhatsApp → Templates** ## Create a template 1. Marketing → WhatsApp → Templates → **Create** 2. Match Twilio Content Template structure (header, body, buttons, variables) 3. Save in DistantRace — then submit the same design in [Twilio Console](https://console.twilio.com/) for Meta approval See [Twilio setup → WhatsApp message design](twilio.md) for Meta category tips (use **Utility** for result notifications when possible). ## Template detail Track approval status synced from Twilio. Only **approved** templates appear in [WhatsApp campaigns](whatsapp-campaigns.md). ## Test send On a template detail page, enter a phone number in international format (`+371...`) and **Send test** to preview how the message renders in WhatsApp before running a campaign. ## Delete template Remove a template from DistantRace and Twilio when it is no longer needed. Deleting an in-use template blocks future campaigns that reference it. ## Variables Templates use placeholders for participant name, event name, result link, etc. Fill variables when sending a campaign. ## Related - [WhatsApp campaigns](whatsapp-campaigns.md) - [Twilio](twilio.md) --- # Introduction to organizing competitions URL: /en/introduction-to-organizing-competitions/ # Introduction to organizing competitions Getting started as an event organizer. Most operational guides now live in **[Running events](../running-events/index.md)** — create events, finance, start lists, results, and integrations. ## In this section | Guide | What it covers | |-------|----------------| | [Introduction to DistantRace](introduction-to-distantrace.md) | Platform overview for organizers | | [From what age can participants join](from-what-age-can-participants-join-the-competitions.md) | Age rules and child accounts | ## Moved to Running events | Former topic | New guide | |--------------|-----------| | Access the manager console | [Access the organizer console](../running-events/access-the-organizer-console.md) | | Create a club | [Create a club](../running-events/create-a-club.md) | | Club settings and admins | [Club settings and admins](../running-events/club-settings-and-admins.md) | | How costs are formed | [Costs and pricing](../running-events/costs-and-pricing.md) | | Individual join passwords | [Join codes and invitations](../running-events/join-codes-and-invitations.md) | ## Quick links by event type | Event type | Start here | |------------|------------| | Step challenge | [Create a step challenge](../running-events/create-a-step-challenge.md) | | Sports challenge | [Create a sports activity challenge](../running-events/create-a-sports-activity-challenge.md) | | Virtual competition | [Create a virtual competition](../running-events/create-a-virtual-competition.md) | | In-person race | [Create an in-person race](../running-events/create-an-in-person-race.md) | Older BookStack URLs under `/en/books/introduction-to-organizing-competitions/` redirect to the matching pages. --- # From what age can participants join competitions? URL: /en/introduction-to-organizing-competitions/from-what-age-can-participants-join-the-competitions/ # From what age can participants join competitions? DistantRace can create 2 types of sports events: - In-person competitions - Virtual competitions and challenges To participate in in-person competitions, it is not mandatory for participants to have an account on distantrace.com, so in such competitions, if planned by the organizer, children up to 13 years old can also participate. For virtual competitions and challenges, each participant needs their own account on distantrace.com, as we need to obtain sports activity data that is associated with a specific user. Although according to GDPR, registration on various platforms is allowed from the age of 16, member states can set a lower age, but not lower than 13 years old. In Latvia, this age is determined by Article 33 of the "Personal Data Processing Law," which states that a child's data cannot be processed without the permission of a parent or guardian. Therefore, we cannot allow children under the age of 13 to join challenges and virtual competitions. To address this situation, our platform allows parents or guardians of children younger than 13 years old to create a sub-account, in which they can indicate which activity the child has performed. In each competition, it is possible to enable/disable the use of such sub-accounts. --- # Introduction to DistantRace URL: /en/introduction-to-organizing-competitions/introduction-to-distantrace/ # Introduction to DistantRace DistantRace is a multifunctional platform that integrates with sports applications to create challenges and competitions for companies, clubs, and friends. To create events, you need a **club** (organization) on DistantRace. A club can be a company name, event brand, or personal organizer name. DistantRace also provides an API for integrations — for example connecting to a company HR system. ## Event types All events on DistantRace fall into four groups: 1. [Daily step challenges](../daily-step-challenges/introduction-to-daily-steps.md) 2. [Sports activity challenges](../running-events/create-a-sports-activity-challenge.md) 3. [Virtual competitions](../running-events/create-a-virtual-competition.md) 4. [In-person competitions](../running-events/create-an-in-person-race.md) For a complete organizer guide, see [Running events](../running-events/index.md). ## Daily step challenges The simplest challenge type — daily steps from phone or smartwatch. [Introduction to daily steps](../daily-step-challenges/introduction-to-daily-steps.md) | [Create a step challenge](../running-events/create-a-step-challenge.md) ## Sports activity challenges Athletic challenges where participants record sports app activities (start/stop). Distance, time, active days, or points accumulate. [Create a sports activity challenge](../running-events/create-a-sports-activity-challenge.md) ## Virtual competitions Timed virtual races — for example who runs 5 km fastest within the event window. [Create a virtual competition](../running-events/create-a-virtual-competition.md) ## In-person competitions Registration, payments, start lists, and results for physical events. [Create an in-person race](../running-events/create-an-in-person-race.md) | [Register as a participant](../joining-events/register-for-in-person-competitions.md) --- # Joining events URL: /en/joining-events/ # Joining events Use this section if you want to **participate** in a challenge or competition on DistantRace. ## Before you register 1. [Create an account](create-an-account.md) 2. [Getting started after signup](getting-started-after-signup.md) — profile, connect apps, suggested events 3. [Which type of event is this?](which-type-of-event-is-this.md) — challenge vs virtual competition vs in-person race ## Connect your data source Most events need a connected sports app or step source: - [Supported apps](../connections-with-apps/supported-apps.md) - [Data synchronization troubleshooting](../connections-with-apps/data-synchronization-problems/the-most-common-reasons-for-data-synchronization-issues.md) ## Register for an event | Event type | Guide | |------------|-------| | Step or sports challenge | [Participate in a challenge](participate-in-a-challenge.md) | | Virtual timed race | [Participate in virtual competitions](participate-in-virtual-competitions.md) | | In-person race | [Register for in-person competitions](register-for-in-person-competitions.md) | | Private event (code required) | [Using a join code](using-a-join-code.md) | | Email invitation link | [Email invitation links](email-invitation-links.md) | | Group cart link | [Joining via dynamic cart link](joining-via-dynamic-cart-link.md) | | Partner / reserved link | [Using a reserved entry link](using-a-reserved-entry-link.md) | | Race day (QR) | [Race-day registration as a participant](race-day-registration-as-a-participant.md) | | In-store desk | [In-store registration](in-store-registration.md) | ## Find and access events - [Mobile app](../mobile-app/index.md) — install, step sync, QR join, and settings - [Challenge onboarding page](challenge-onboarding-page.md) — organizer-shared instructions - [Find an event in the app](find-an-event-in-the-app.md) - [Mobile app and step challenges](mobile-app-and-step-challenges.md) ## Teams and family registration - [Joining a team](joining-a-team.md) - [Registering for someone else](registering-for-someone-else.md) ## After you join - [After joining a challenge](after-joining-a-challenge.md) - [Managing your activities](managing-your-activities.md) - [Daily steps on the website](daily-steps-on-the-website.md) - [My competition registrations](my-competition-registrations.md) - [Transferring your registration to someone else](transferring-your-registration-to-someone-else.md) - [Virtual map progress](virtual-map-progress.md) · [Geo challenge maps](geo-challenge-maps.md) - [Selecting your virtual race workout](selecting-your-virtual-race-workout.md) - [Viewing competition standings and team results](viewing-competition-standings-and-team-results.md) - [Viewing your race result](viewing-your-race-result.md) - [Downloading diplomas and certificates](downloading-diplomas-and-certificates.md) - [Viewing the start list](viewing-the-start-list.md) - [Comparing virtual race results](comparing-virtual-race-results.md) - [Viewing competition course maps](viewing-competition-course-maps.md) - [Step game daily tasks](step-game-daily-tasks.md) - [Challenge message board](challenge-message-board.md) - [Express registration](express-registration.md) - [Post-registration add-ons](post-registration-add-ons.md) - [Why activities are missing](why-activities-are-missing.md) ## Payments and invoices - [My purchases and orders](my-purchases-and-orders.md) - [Downloading invoices and receipts](downloading-invoices-and-receipts.md) - [Checkout add-ons and shipping](checkout-add-ons-and-shipping.md) - [Adding Omniva shipping after checkout](adding-omniva-shipping-after-checkout.md) - [Picking a start time slot](picking-a-start-time-slot.md) ## Your account - [Your profile and participant profiles](your-profile-and-participant-profiles.md) - [Managing your account settings](managing-your-account-settings.md) - [Managing saved participant profiles](managing-saved-participant-profiles.md) - [Sign-in options](sign-in-options.md) - [Enterprise SAML and whitelabel login](enterprise-saml-and-whitelabel-login.md) — branded portals and SSO - [Two-factor authentication](two-factor-authentication.md) - [Linking a participant profile](linking-a-participant-profile.md) - [Personal activity exclusion zones](personal-activity-exclusion-zones.md) - [Resolving duplicate social accounts](resolving-duplicate-social-accounts.md) - [Registering interest before signup](registering-interest-before-signup.md) - [Event regulations and consent](event-regulations-and-consent.md) - [Club membership](club-membership.md) - [Notification preferences](notification-preferences.md) - [Delete your account](delete-your-account.md) ## Help and feedback - [Contact the organizer](contact-the-organizer.md) - [Contact support from the app](contact-support-from-the-app.md) - [Leaving an event review](leaving-an-event-review.md) ## Other - [Withdraw from an event](withdraw-from-an-event.md) - [Age restrictions and children](age-restrictions-and-children.md) --- # Adding Omniva shipping after checkout URL: /en/joining-events/adding-omniva-shipping-after-checkout/ # Adding Omniva shipping after checkout If you registered and paid but did not add **Omniva parcel delivery** during checkout, the organizer may send a link to add shipping details afterward. **URL pattern:** `/shop/quick/add_omniva/?c=` The cart code is unique to your paid order. Organizers copy the link from the order in the manager console or include it in a custom email (for example when merchandise ships after a virtual race). ## When you need this - Registration completed without selecting a parcel terminal - Organizer sells merchandise that ships after the race - You paid on race day and must add delivery before fulfillment - Checkout did not show shipping because the Omniva product was added only after you registered The link opens only for valid, paid carts that include products eligible for Omniva shipping (`SHIPPING_OMNIVA` product class on the event). ## What you see on the page 1. **Order header** — Omniva product name and your order number (`#123`). 2. **Organizer** — the club fulfilling the shipment. 3. **Participants in order** — ticket holders linked to this cart (useful for family or group checkouts). 4. **Form** (if shipping is not yet saved): - **Phone number** — required for Omniva SMS updates; may pre-fill from billing data. - **Parcel machine** — searchable dropdown of Omniva parcel terminals (loaded from the public Omniva location list). If shipping was already submitted, the page shows a read-only confirmation with the selected terminal and phone number instead of the form. ## Steps 1. Open the link while logged in as the payer (or the account that owns the order). 2. Enter **phone number** for courier SMS updates. 3. Choose **parcel terminal** from the Omniva list. 4. Submit — shipping is saved on your order (`have_shipping` on the cart). ## After submitting The organizer sees updated shipping data in [Managing Omniva shipments](../running-events/managing-omniva-shipments.md) and can generate parcel labels from the competition **Shipping** view. You can review the order under [My purchases and orders](my-purchases-and-orders.md). ## Troubleshooting | Issue | What to do | |-------|------------| | Link does not open | Cart code may be invalid or expired — contact the [organizer](contact-the-organizer.md) | | No terminals listed | Omniva integration may not be enabled for this event — see [Omniva shipping](../integrations/omniva-shipping.md) | | Already added shipping | Page shows confirmation — use My purchases to verify; do not submit twice | | Wrong terminal shown | Contact the organizer before labels are generated | ## Related - [Checkout add-ons and shipping](checkout-add-ons-and-shipping.md) - [Post-registration add-ons](post-registration-add-ons.md) - [Omniva shipping](../integrations/omniva-shipping.md) (organizer setup) --- # After joining a challenge URL: /en/joining-events/after-joining-a-challenge/ # After joining a challenge Once registered, the challenge page becomes your hub for results, progress, and communication. ## Main navigation tabs Depending on challenge settings, you may see: | Tab | Purpose | |-----|---------| | **Overview** | Rules, dates, goals, progress | | **Results** | Public leaderboard | | **My result** | Your activities, steps, points breakdown | | **My team** | Team standings (if teams enabled) | | **Messages** | Organizer and participant posts (if enabled) — [Challenge message board](challenge-message-board.md) | | **Step game** | Daily tasks in step/combined challenges — [Step game daily tasks](step-game-daily-tasks.md) | | **Standings** | Series or stage standings | | **Analytics** | Personal stats (if enabled) | | **Custom pages** | Info pages added by the organizer | ## Recording activities - **Step challenges:** carry your phone or sync your watch; steps update automatically. - **Sports challenges:** record workouts in your connected app with Start/Stop. - See [Why activities are missing](why-activities-are-missing.md) if data does not appear. ## Results hidden periods Organizers can temporarily hide the public leaderboard. You can still view **My result** during hidden periods unless the organizer blocked that too. ## Activity backfill When you join mid-challenge, activities you already recorded **inside the challenge dates** may appear on your result shortly after registration. ## First-sync reminders If you have no connected app or no synced activities, DistantRace may email you reminders with links to connection guides. ## Next steps - [Participate in a challenge](participate-in-a-challenge.md) — full registration flow - [Challenge onboarding page](challenge-onboarding-page.md) — setup help from the organizer --- # Age restrictions and children URL: /en/joining-events/age-restrictions-and-children/ # Age restrictions and children ## Minimum age Event organizers can set **minimum and maximum birth years** on registration. You cannot join if your age is outside the allowed range. DistantRace accounts generally require participants to be at least **13 years old** to register independently, in line with data-protection rules in several countries (including Latvia). ## Children under 13 Children under 13 **cannot create their own DistantRace login**. Instead: 1. A parent or guardian creates their own account. 2. The parent creates a **sub-account** for the child. 3. The parent registers the child for events using that sub-account. See [Registering for someone else](registering-for-someone-else.md). Activities must still sync from a connected device or app — often the parent's phone or watch. ## Organizer settings Organizers configure age limits under **Settings → Registration**. Some challenges also allow **child subaccounts** in advanced settings so parents can register children under the age limit when permitted. Organizer reference: [Challenge settings reference](../running-events/challenge-settings-reference.md#registration). ## Related - [From what age can participants join](../introduction-to-organizing-competitions/from-what-age-can-participants-join-the-competitions.md) (organizer view) --- # Challenge message board URL: /en/joining-events/challenge-message-board/ # Challenge message board When the organizer enables it, the **Messages** tab is a social feed for the challenge — participant posts, organizer announcements, comments, and likes. **Path:** Challenge page → **Messages** (`/challenges//messages/`) If the tab is missing, the organizer disabled the message board. On **public** challenges, messages are off by default until the organizer turns them on. Visiting `/messages/` directly redirects to the challenge home when the board is disabled. ## Who can post | Who | What they see | |-----|----------------| | **Registered participant** | Full feed, **Add message** button, comments, and likes | | **Signed-in non-participant** | Feed is readable, but posting is locked — join the challenge first | | **Visitor** | Same locked state if the challenge is public | ## Read posts The feed shows newest posts first and loads more as you scroll (10 posts at a time). Each post may include: - Text from a participant, the organizer, or **DistantRace** (system messages) - One or more **photos** — thumbnails load on demand; tap to open full size - **Like** count and **comment** count Click a post to expand **comments** or see who liked it. ## Create a post 1. Open **Messages** while logged in as a registered participant. 2. Write your message (up to 5000 characters). 3. Optionally attach **multiple images**. 4. Submit — the post appears for other participants. Empty messages are rejected. ## Comment and like - **Comment** on a post to reply in a thread under that message. - **Like** a post once — likes are visible to other participants. There is no unlike. Posting messages, commenting, and posting images may count toward [Step game daily tasks](step-game-daily-tasks.md) when the organizer configured those goal types. ## Organizer posts Club staff can post as the **organizer** — these appear with the club name and logo on a highlighted header. Use the board for announcements, motivation, or Q&A. When the feed is empty and you are a participant, you see a **No messages yet** prompt with the add button. ## Related - [After joining a challenge](after-joining-a-challenge.md) - [Contact the organizer](contact-the-organizer.md) --- # Challenge onboarding page URL: /en/joining-events/challenge-onboarding-page/ # Challenge onboarding page Every challenge has an **onboarding page** — a step-by-step guide the organizer can share with participants. It explains how to find the event, install the app, connect data sources, and register. ## Open the onboarding page Organizers share the onboarding URL from **Easy Access** in the manager console, or you find an **Onboarding** button on the challenge page. The URL pattern is: `https://distantrace.com//challenges//onboarding/` ## What the page covers 1. **How to access the challenge** — event link, join code, or QR scan in the app 2. **Download the DistantRace app** — iOS and Android store links 3. **Create an account and connect apps** — links to connection guides 4. **Platform-specific sync help** — Android steps, Apple Health, Samsung Health, Huawei, and more 5. **Register for the challenge** — link to the apply form ::: tip Step challenges need the app For step challenges, daily steps are sent through the DistantRace mobile app. The onboarding page states when the app is required. ::: ## Help links The onboarding page links to detailed documentation for: - [Supported apps](../connections-with-apps/supported-apps.md) - [Data synchronization issues](../connections-with-apps/data-synchronization-problems/the-most-common-reasons-for-data-synchronization-issues.md) - [Find a challenge in the app](find-an-event-in-the-app.md) ## After onboarding Once registered, see [After joining a challenge](after-joining-a-challenge.md) for what you see on the challenge page. Organizers configure sharing from [Share your event (Easy Access)](../running-events/share-your-event-easy-access.md). --- # Checkout add-ons and shipping URL: /en/joining-events/checkout-add-ons-and-shipping/ # Checkout add-ons and shipping During registration you may be offered **optional products** (t-shirts, medals, merchandise) and **delivery options** if the organizer configured them. ## Add-on products After selecting your ticket or distance, the checkout may show: - Single products (one price) - Variations (size, color) - Product choices (pick one from a list) Prices add to your cart total before payment. ## Shipping If physical products include delivery: 1. Enter or confirm your shipping address 2. Select delivery method (e.g. Omniva parcel terminal or courier) 3. Shipping cost is added to the total The organizer fulfills orders after payment — see organizer guide [Upsell products in checkout](../running-events/upsell-products-in-checkout.md). Missed Omniva during checkout? You may receive a link to [add shipping afterward](adding-omniva-shipping-after-checkout.md). ## Multiple participants When registering several people in one checkout, add-ons can be assigned per participant. ## Related - [Register for in-person competitions](register-for-in-person-competitions.md) - [Participate in virtual competitions](participate-in-virtual-competitions.md) --- # Club membership URL: /en/joining-events/club-membership/ # Club membership **Path:** Profile → **My clubs** (`/accounts/my_clubs/`) ## What is a club membership Joining a **club-only** or **club-access** event may add you to the organizer's club roster. Membership unlocks private events and club-branded pages. ## View your clubs The list shows clubs you belong to with links to the public club page and active events. ## Leave a club Use **Leave club** on the club detail page in your profile. Before leaving you must **withdraw from all active events** in that club — otherwise leave is blocked. When leave succeeds, DistantRace **anonymizes** your name and results in that club's past challenges and virtual competitions (including sub-accounts you registered). This cannot be undone. Leaving does not delete your DistantRace account or affect other clubs. Withdraw from active events first — [Withdraw from an event](withdraw-from-an-event.md). ## Related - [Using a join code](using-a-join-code.md) - [Which type of event is this?](which-type-of-event-is-this.md) --- # Comparing virtual race results URL: /en/joining-events/comparing-virtual-race-results/ # Comparing virtual race results Virtual competitions may offer **route comparison** — overlay your GPS track with another participant's on the same course. ## Open compare view From the public **Results** page, select two finishers and choose **Compare** (when enabled by the organizer). ## What you see - Map with both tracks overlaid - Distance and time at key segments - Useful for virtual relays and club training events Requires both participants to have submitted valid GPS activities — see [Reviewing virtual workouts](../running-events/reviewing-virtual-workouts.md). ## Related - [Participate in virtual competitions](participate-in-virtual-competitions.md) - [Managing your activities](managing-your-activities.md) --- # Contact support from the app URL: /en/joining-events/contact-support-from-the-app/ # Contact support from the app The DistantRace **mobile app** includes an in-app support form for technical issues. See also [Help and troubleshooting](../mobile-app/help-and-troubleshooting.md) in the [Mobile app](../mobile-app/index.md) section. ## Submit a ticket 1. Open app → **Settings** or **Help** 2. Choose **Contact support** / **Report a problem** 3. Describe the issue and attach screenshots if offered 4. Submit — includes app version and device info automatically ## When to contact support vs organizer | Issue | Contact | |-------|---------| | App crash, login, sync bugs | DistantRace support | | Race rules, refunds, bib numbers | [Event organizer](contact-the-organizer.md) | General email: support@distantrace.com ## Related - [Help and troubleshooting](../mobile-app/help-and-troubleshooting.md) - [Sign-in options](sign-in-options.md) - [Find an event in the app](find-an-event-in-the-app.md) --- # Contact the organizer URL: /en/joining-events/contact-the-organizer/ # Contact the organizer Each public event page includes a **Contact organizer** form. ## When to use it - Registration problems (payment not confirmed, wrong distance) - Missing bib or start slot questions - Accessibility or special requirements - General event information not covered on info pages ## How to send 1. Open the challenge or competition public page 2. Find **Contact us** or **Contact organizer** 3. Fill name, email, and message 4. Submit — the message goes to the club email configured in [Club settings](../running-events/club-settings-and-admins.md) ## Response time Organizers respond directly — DistantRace does not mediate. Allow 1–2 business days before events. ## Related - [My competition registrations](my-competition-registrations.md) - [Contact support from the app](contact-support-from-the-app.md) --- # Create an account URL: /en/joining-events/create-an-account/ # Create an account To join events on DistantRace, create a free account at [distantrace.com](https://distantrace.com). ## Registration steps 1. Go to the DistantRace homepage. 2. Open **Log In**, then **Registration**. 3. Enter your email, password, first name, last name, birth date, and gender. Country and city are optional. 4. Or sign up with **Google, Apple, or Facebook** — you still need to confirm your email. 5. Accept the terms of use and privacy policy. 6. Click **Register** and confirm your email with the code sent to your inbox (check spam if needed). ::: tip One account on all devices Use the same account on your computer and phone. Multiple accounts are a common reason activities and registrations do not match. ::: ## After signup Complete the [getting started flow](getting-started-after-signup.md): participant profile, connect sports apps, and browse suggested events. Then follow [Which type of event is this?](which-type-of-event-is-this.md) to register for your event. --- # Daily steps on the website URL: /en/joining-events/daily-steps-on-the-website/ # Daily steps on the website Step challenge participants can view daily totals and manage step sources from the **web profile** (not only the mobile app). **Path:** Profile → **Daily steps** (`/accounts/daily_stats/`) ## Step history Calendar or list view of synced steps per day with last sync timestamp. ## Change step source Select which connected provider supplies steps (Apple Health via app, phone pedometer, Fitbit, etc.). Only one primary source should be active to avoid double counting. On the web you can also open **Step data source** (`/accounts/step_data_source/`) to pick the active daily-step provider after connecting apps. Mobile setup: [How to set up a step data source in the DistantRace app](../connections-with-apps/how-to-set-up-a-step-data-source-in-the-distantrace-app.md). ## Troubleshooting Missing days? See [Why activities are missing](why-activities-are-missing.md) and [Data synchronization troubleshooting](../connections-with-apps/data-synchronization-problems/the-most-common-reasons-for-data-synchronization-issues.md). ## Related - [Mobile app and step challenges](mobile-app-and-step-challenges.md) - [Participate in a challenge](participate-in-a-challenge.md) --- # Delete your account URL: /en/joining-events/delete-your-account/ # Delete your account You can delete your DistantRace account from profile settings. **Path:** Profile → **Delete account** (`/accounts/profile/delete/`) — see [Managing your account settings](managing-your-account-settings.md) ## Before you delete - **Export data** you need — activity history cannot be recovered - **Active events** — you may need to [withdraw](withdraw-from-an-event.md) from paid registrations first; deletion may be blocked while you owe unpaid carts - **Connected apps** — Garmin, Polar, etc. are disconnected automatically ## What is removed - Login credentials and profile - Saved participant profiles - Connection tokens to sports apps Historical results in events you joined may remain anonymized on organizer start lists per event rules. ## Related - [Create an account](create-an-account.md) - [Notification preferences](notification-preferences.md) --- # Downloading diplomas and certificates URL: /en/joining-events/downloading-diplomas-and-certificates/ # Downloading diplomas and certificates When organizers enable finisher documents, your **diploma** or **certificate** appears after your result is published. ## Where to find your diploma ### Result detail page 1. Open the competition **Results** page on the public site. 2. Find your name or click your result link. 3. On the **result detail** page, the finisher **diploma image** appears when generated. 4. Click the image or download link to save the file. The same page may show your time, map, and nearby finishers — see [Viewing your race result](viewing-your-race-result.md). ### Direct link sharing Result pages support social sharing. When a diploma exists, preview images use the diploma artwork. ## How organizers create diplomas Organizers design a **PowerPoint (PPTX) template** with merge-field placeholders and upload it in the manager console. DistantRace generates a personalized diploma image for each participant. See the organizer guides: - [Diplomas and finisher documents](../results/diplomas-and-finisher-documents.md) — overview for races and challenges - [Create diplomas for step challenges](../daily-step-challenges/how-to-create-diplomas-for-all-participants.md) - [Race certificate creation](../results/race-certificate-creation.md) — full PPTX design reference ## Not visible yet? - Results may still be **draft** — wait for the organizer to [publish](../results/publishing-results.md) - Virtual races need a **submitted or finalized** workout — [Selecting your virtual race workout](selecting-your-virtual-race-workout.md) - DNF/DNS statuses may not receive finisher documents Contact the [organizer](contact-the-organizer.md) if you finished but see no diploma after results are public. ## Related - [Viewing competition standings and team results](viewing-competition-standings-and-team-results.md) - [My competition registrations](my-competition-registrations.md) --- # Downloading invoices and receipts URL: /en/joining-events/downloading-invoices-and-receipts/ # Downloading invoices and receipts When you pay for event registration (or buy add-ons), DistantRace can issue a **PDF invoice** for your records or company accounting. ## Company invoice at checkout On the billing step before payment: 1. Click **Invoice needed for a company** (or similar) to expand company fields 2. Fill in company name, registration number, VAT number (if applicable), country, and address 3. Optional: tick **Hide participant names on the invoice** if the invoice should list only the payer, not each racer name These details appear on the PDF invoice. ## When you receive the invoice | Payment method | When the invoice is available | |----------------|------------------------------| | **Card / online banking** (Stripe, Montonio, bank link) | After payment succeeds — final paid invoice | | **Prepay invoice / bank transfer** | Immediately after confirming the order — advance invoice with payment instructions | | **Free registration** | Usually no invoice (€0 total) | ### Right after checkout On the confirmation page, click **Open invoice** to download the PDF. ### Later — from your account 1. Log in at [distantrace.com](https://distantrace.com) 2. Open **My purchases** (`/accounts/my_purchases/`) 3. Open the order 4. Click **Download invoice** ### By email - **Bank transfer:** you receive a **pre-invoice** email with the PDF attached or linked — pay using the reference number shown on the invoice - **Card / online payment:** order confirmation email includes a link to your order and invoice Guests (not logged in) can open the order summary from the link on the checkout confirmation page without an account. ## Bank transfer — paying the invoice 1. Download the pre-invoice PDF 2. Pay the exact amount via your online bank 3. **Include the invoice number** in the payment reference field 4. The organizer may match payment automatically (if open banking is enabled) or manually — registration completes when payment is confirmed Bank transfers are typically processed **twice per day**. Contact the event organizer if your payment is not confirmed within a few business days. ## Multiple invoices on one order If your cart includes items from more than one organizing club, you may receive **one invoice per organizer**. Each PDF is downloadable separately from the order page. ## VAT and billing country Invoice VAT depends on the payer's country and VAT registration. EU companies with a valid VAT ID may see reverse-charge wording on B2B invoices. ## Related - [My purchases and orders](my-purchases-and-orders.md) - [Register for in-person competitions](register-for-in-person-competitions.md) - [Checkout add-ons and shipping](checkout-add-ons-and-shipping.md) - Organizer view: [Invoicing](../finance-module/invoicing.md) --- # Email invitation links URL: /en/joining-events/email-invitation-links/ # Email invitation links Organizers can send **email invitations** with a personal join code. The link may log you in and enroll you in the challenge automatically. ## How the link works 1. You receive an email from the organizer or DistantRace with an invitation link. 2. Click the link. If you do not have an account, you are guided to sign up or log in. 3. DistantRace validates the join code tied to the link. 4. Depending on the event settings, you may be **enrolled immediately** or sent to the registration form. ## When auto-enroll happens Automatic enrollment works when the challenge has: - No required custom registration questions - No age restriction that blocks you - A clear distance assignment (if the challenge uses multiple distances) If any of these apply, you are redirected to the normal [registration form](participate-in-a-challenge.md) instead. ::: warning Required questions block auto-enroll If the organizer added mandatory apply questions or age limits, you must complete the registration form even after clicking the email link. ::: ## After auto-enroll - You appear on the participant list - Past activities in the challenge window may be **backfilled** to your result - Connect your sports app if you have not already — see [Supported apps](../connections-with-apps/supported-apps.md) ## Troubleshooting | Problem | What to do | |---------|------------| | Link expired or invalid | Ask the organizer for a new invitation | | Code already used | Each individual code works for one account only | | Redirected to apply form | Complete the form; the code is still applied | | Wrong distance shown | Contact the organizer — the code may be tied to a specific distance | ## Related - [Using a join code](using-a-join-code.md) - [Join codes and invitations](../running-events/join-codes-and-invitations.md) (organizers) --- # Enterprise SAML and whitelabel login URL: /en/joining-events/enterprise-saml-and-whitelabel-login/ # Enterprise SAML and whitelabel login Some clubs run on a **whitelabel** DistantRace deployment — a branded website on a custom domain with **enterprise single sign-on (SSO)** via SAML (commonly Microsoft Entra ID / Azure AD), or OAuth-based login through DistantRace. ## Who this applies to - Corporate or federation clubs with whitelabel enabled - Participants expected to use a **work email** domain (for SAML) - Organizations that route login through a branded portal instead of distantrace.com Standard distantrace.com users use [Sign-in options](sign-in-options.md) (email, Google, Apple, passkey). ## Branded participant portal On a whitelabel site you typically: 1. Open your **club's branded URL** (not distantrace.com). 2. Browse published challenges and events without logging in. 3. Click **Sign in** when you want to join, sync workouts, or manage your profile. Sign-in redirects to DistantRace OAuth with your organization's UUID in the authorize URL. Login pages use your club's **themed** templates (logo, colors, copy) when the club has a non-default `domain_theme`. After authentication you return to the branded site, already logged in. DistantRace resolves branding from: 1. **Session flags** set during a themed login on your portal 2. **Verified embed domain** — the host in your portal URL or OAuth `next` link maps to your club via [Embed domains](../running-events/embed-domains-for-iframes.md) What the portal shows — leaderboards, team results, competition checkout, workout history — depends on how your club's portal is configured. Event rules and registration still come from the organizer's DistantRace settings. Organizer-facing overview: [Whitelabel and enterprise setup](../running-events/whitelabel-and-enterprise-setup.md). ## SAML / enterprise SSO For clubs with SAML configured: 1. Open the club's branded URL or a direct event link. 2. Click **Sign in with work account** / organization login (or start from a SAML-aware entry point). 3. Enter your **work email** if prompted — DistantRace routes you to the correct identity provider by email domain (`/saml2/discovery/`). 4. Complete authentication at your company's Microsoft (or configured IdP) portal. 5. Return to DistantRace logged in — register for events as usual. If your domain is not configured, you see an error asking you to contact your IT administrator. ### Multiple identity providers When several SAML providers exist, the discovery page matches your email **domain** to the right IdP before redirecting to `/saml2/login/?idp=…`. If only one IdP is configured, discovery skips the form and sends you straight to login. ### Discovery errors | Message | Meaning | |---------|---------| | Enter a valid work email | Missing or malformed address | | We don't have Single Sign-On configured for this domain | Your IT team has not registered that email domain with DistantRace | Contact your club administrator or IT if your domain should be supported. ## Other login methods on whitelabel Depending on club configuration, themed login pages may also offer: | Method | Notes | |--------|-------| | **Email login code** | One-time code sent to your inbox; uses your club's [SendGrid](../integrations/sendgrid.md) sender when configured | | **Passkey (WebAuthn)** | Passwordless login if you registered a passkey on a previous visit | | **OAuth (authorization code)** | Default flow for branded web portals — browser redirects through DistantRace and back | Sport app connections (Garmin, Strava, step sources) open on the canonical DistantRace auth host for OAuth provider redirects. A signed **social return** token in the URL brings you back to the branded portal with the same theme, even though provider OAuth runs on distantrace.com. ## Whitelabel branding Whitelabel clubs may show: - Club logo and colors on login and account pages - Custom hero images on the public portal - Branded transactional email (login codes, invitations) via SendGrid Organizer setup for domains, SAML, and portal hosting is platform-managed — contact DistantRace to enable whitelabel for your organization. ## Organizers on whitelabel clubs Manager console access still requires [Two-factor authentication](two-factor-authentication.md). SSO or OAuth handles participant login on the branded site; 2FA is a separate security step for `/console/` views on distantrace.com. ## API access Whitelabel organizations can use the REST API with organization-scoped credentials — see [Public API overview](../more-tools/public-api-overview.md). ## Related - [Whitelabel and enterprise setup](../running-events/whitelabel-and-enterprise-setup.md) - [Club branding and hero images](../running-events/club-branding-and-hero-images.md) - [Sign-in options](sign-in-options.md) - [Email invitation links](email-invitation-links.md) --- # Event regulations and consent URL: /en/joining-events/event-regulations-and-consent/ # Event regulations and consent During registration you may need to accept **event regulations**, privacy terms, or custom consent checkboxes before your entry is confirmed. ## At registration Common items: - **Competition regulations** — rules, cutoff times, disqualification grounds - **Liability / participation terms** — standard DistantRace or club-specific wording - **Marketing consent** — optional emails from the organizer (separate from DistantRace system mail) - **Health or age declarations** — self-certification for minors or medical fitness Required boxes must be checked to complete registration. Optional marketing consent can be declined without blocking signup. ## Where organizers configure this Organizers attach regulation text and questions in competition or challenge settings — see [Competition settings reference](../running-events/competition-settings-reference.md) and [Challenge settings reference](../running-events/challenge-settings-reference.md). ## After you register - Re-read rules on the competition **Info** or **Overview** page - Contact the [organizer](contact-the-organizer.md) if regulations changed after you signed up - Marketing preferences may be updated under [Notification preferences](notification-preferences.md) where applicable ## Minors Events with age limits may require guardian consent — [Age restrictions and children](age-restrictions-and-children.md). ## Related - [Register for in-person competitions](register-for-in-person-competitions.md) - [Participate in a challenge](participate-in-a-challenge.md) --- # Express registration URL: /en/joining-events/express-registration/ # Express registration Some virtual and challenge-style **competitions** offer **express registration** — a shortened single-page form instead of the full multi-step checkout. **URL pattern:** `competitions//apply/express/` Opening `/apply/` on a virtual-style competition **redirects automatically** to the express form. ::: note Challenges use a different flow Step and sports **challenges** register at `/challenges//apply/` — not the express competition form. See [Participate in a challenge](participate-in-a-challenge.md). ::: ## When express apply is used Express registration is available for **virtual**, **distant race**, and **challenge race** competitions — not for standard **in-person** races, **ticket** events, or **collection** events (those use the full `/apply/` flow). Paid events still redirect to payment after the form when a fee applies. ## Before you start You must be **signed in**. If you open express apply while logged out, DistantRace asks for your email and sends you to sign up or log in — it does not collect full registration details anonymously. Private competitions require a valid [join code](using-a-join-code.md) in the URL (`?join_code=`) or a short-lived session cache (about 15 minutes) before the form opens. Organization-wide join codes work too. ## What you fill in Typically on one page: - Personal details (name, gender, birth date if required) - **Distance** or category - **Team** — pick an existing team or create one in a modal when the distance allows teams - Registration questions from the organizer - Agreement to [event regulations](event-regulations-and-consent.md) If you already registered for this event, the page lists your existing entry with an option to **quit** (withdraw) and apply again — unless you bought a premium package that blocks quitting. ## Registering someone else Express apply links to a **sub-participant** list at `apply/express/sub/` when the event allows family or group entries. You can also open the main form with `?p=` for a saved profile. See [Registering for someone else](registering-for-someone-else.md). ## After submit - **Free events** — confirmation at `apply/ok/?e=`; you may see [post-apply add-ons](post-registration-add-ons.md) or premium upsells immediately - **Paid events** — redirect to checkout, then confirmation Registration may be blocked when the event is full, outside the registration window, or you reached the organizer's per-user application limit. ## Related - [Participate in virtual competitions](participate-in-virtual-competitions.md) - [Register for in-person competitions](register-for-in-person-competitions.md) --- # Find an event in the app URL: /en/joining-events/find-an-event-in-the-app/ # Find an event in the app In the DistantRace app, challenges can only be found if you have a challenge QR code or a challenge code. For installation, QR login, and other scanner uses, see [Finding and joining events](../mobile-app/finding-and-joining-events.md) in the [Mobile app](../mobile-app/index.md) section. 1. Look for a blue **button with a QR code icon** at the bottom right corner of the app's home screen. 2. A screen will open where you can **scan the challenge QR code**. Scan it, and you'll be directed to the challenge registration screen. 3. If you don't want to or can't scan the QR code, for example, if the QR code is in your phone's web browser, tap "Enter code manually." 4. A screen will open where you can **enter the challenge code**. Enter it, and you'll be directed to the challenge registration screen. ![Screenshot 2024-11-04 at 07.36.57.png](/static/img/how-to-use-distantrace/challenges/how-to-find-a-challenge-in-the-distantrace-app/screenshot-2024-11-04-at-07-36-57.png) ![Screenshot 2024-11-04 at 07.41.30.png](/static/img/how-to-use-distantrace/challenges/how-to-find-a-challenge-in-the-distantrace-app/screenshot-2024-11-04-at-07-41-30.png) ![Screenshot 2024-11-04 at 07.43.04.png](/static/img/how-to-use-distantrace/challenges/how-to-find-a-challenge-in-the-distantrace-app/screenshot-2024-11-04-at-07-43-04.png) --- # Geo challenge maps URL: /en/joining-events/geo-challenge-maps/ # Geo challenge maps **Geo challenges** require visiting **checkpoints** on a map. Your GPS activities must pass through defined areas to score points. ## View checkpoints Open the challenge page **Map** tab to see checkpoint locations and which you have visited. ## Submit activities Record outdoor activities with GPS using a [connected app](../connections-with-apps/supported-apps.md). Indoor or GPS-less activities typically do not count. ## Points Each checkpoint awards points when your track intersects the geo area. Leaderboard ranks total geo points. Organizer setup: [Geo location restrictions](../running-events/geo-location-restrictions.md). ## Related - [Virtual map progress](virtual-map-progress.md) - [Managing your activities](managing-your-activities.md) --- # Getting started after signup URL: /en/joining-events/getting-started-after-signup/ # Getting started after signup After you create a DistantRace account, the platform guides you through three short steps before you can join events. ## Step 1 — Participant profile If you registered with email and have not completed your profile yet, you are asked for your **first name** and **last name**. This creates your **participant profile** — the identity used when you register for races and challenges. ::: tip One account everywhere Use the same account on your computer and phone. Activities sync to one profile; registering with different accounts is a common cause of missing results. ::: If you signed up with Google, Apple, or Facebook, you may skip this step when your name is already known. ## Step 2 — Connect sports apps Next you see available **connections** — Garmin, Polar, Fitbit, and others. Connect at least one service you use to record activities or daily steps. See [Supported apps](../connections-with-apps/supported-apps.md) for the full list and setup guides. For **step challenges**, you also need the DistantRace mobile app to send daily steps from Apple Health, Google Fit, or Health Connect. ## Step 3 — Suggested events The final step shows **open events** you can join, including events where you previously [registered interest](registering-interest-before-signup.md) before creating an account. You can register from here or skip and browse [public events](https://distantrace.com/en/events/) later. ## What happens next When you open an event link from an organizer, you may also see a dedicated [challenge onboarding page](challenge-onboarding-page.md) with step-by-step instructions for that specific event. --- # In-store registration URL: /en/joining-events/in-store-registration/ # In-store registration Some clubs enable **in-store registration** at a physical location (shop, office, registration desk). ## How it works 1. Visit the club or event location during opening hours 2. Staff help you register on the spot using the in-store checkout 3. You may receive a QR code or email confirmation like online registration ## vs race-day registration | Flow | When | |------|------| | **In-store** | Before the event, at a fixed location during business hours | | [Race-day](race-day-registration-as-a-participant.md) | On event day after online payment closes | Organizer view: [On-site payment and in-store registration](../running-events/on-site-payment-and-in-store-registration.md). ## Related - [Register for in-person competitions](register-for-in-person-competitions.md) --- # Joining a team URL: /en/joining-events/joining-a-team/ # Joining a team Many events support **teams** — department groups, clubs, or open teams created by participants. ## Join via team invite link If the organizer or a teammate sends a link with a team code (`?join_team=...`): 1. Open the link while logged in. 2. The registration form pre-selects that team. 3. Complete registration — you are added to the team. ## Pick a team during registration On the apply form you may see a **team** dropdown: - Choose an existing team, or - Create a new team (if the organizer allows open teams) Some events only allow **pre-defined teams** set by the organizer — in that case you pick from their list. ## Change team after joining Some challenges let you switch teams after registration from the apply or team settings page, unless the organizer locked teams. ## Team results When teams are enabled, you usually see: - **Individual** results on the leaderboard - **Team** standings aggregating member results (often top-N contributors per team) ## Competitions In-person and virtual competitions may require a team for certain ticket types (relay, team distances). The checkout form includes team selection or search. ## Organizer setup Organizers configure teams in [Challenge settings reference](../running-events/challenge-settings-reference.md#teams). --- # Joining via dynamic cart link URL: /en/joining-events/joining-via-dynamic-cart-link/ # Joining via dynamic cart link A **dynamic cart** lets one person (the cart owner) pay for several participants. If you received a link with a cart code, you register yourself into their cart. ## How it works for you 1. Open the link from the organizer or cart owner. It includes a cart code (`?c=...`). 2. Choose your participation ticket (distance). 3. Fill in your participant details. 4. Submit — your entry is added to the owner's cart. 5. The **cart owner** pays for all entries and manages the order. You do not pay directly unless the organizer configured otherwise. ## What happens after you register - Your details appear in the owner's checkout - The owner can edit names and birth dates before payment - After payment, you are on the start list and receive confirmation email ## Teams in dynamic carts The organizer may preset a **team** for everyone registering through the same cart link. You may not be able to change the team. ## Cart owner documentation If you are paying for the group, create the cart from [My purchases and orders](my-purchases-and-orders.md#create-a-group-registration-cart-dynamic-cart). Organizers can also set up partner-specific reserved links in [Partner and corporate registration](../running-events/partner-and-corporate-registration.md). ## Related - [Register for in-person competitions](register-for-in-person-competitions.md) - [Registering for someone else](registering-for-someone-else.md) --- # Leaving an event review URL: /en/joining-events/leaving-an-event-review/ # Leaving an event review After an event, you may be invited to leave a **star rating** (1–5) and short written review. ## Submit a review 1. Open the event page after it ends (or from an email link, if one was sent) 2. Open **Reviews** → **Write a review** 3. Choose stars and optional comment 4. Submit Reviews appear on the public event page and in the organizer's [Participant event reviews](../running-events/participant-event-reviews.md) list. ## Edit or remove Contact the organizer if you need a review removed — self-service edit may not be available. ## Related - [After joining a challenge](after-joining-a-challenge.md) --- # Linking a participant profile URL: /en/joining-events/linking-a-participant-profile/ # Linking a participant profile Sometimes you have a **participant profile** (registrations, results) that is not yet tied to your login. An organizer or email may send a **connect link** to merge it into your account. **URL pattern:** `/accounts/participant//` ## When this happens - You registered **without creating a password** (guest-style entry) - An organizer created your start-list entry manually - You used a different email at registration than on your DistantRace account - Family member entries exist under a standalone profile ## Connect the profile 1. Log in to the DistantRace account you want to keep. 2. Open the connect link from the email or organizer message. 3. Review which registrations will merge. 4. Click **Connect** to attach all racers and history to your logged-in profile. The standalone profile is merged into your primary participant record. ## Decline Choose **Do not connect** if the link was sent in error — you return to your participant list unchanged. ## Already linked If the profile already has a connected user, the link shows an error. Log in as that user or contact [support](contact-support-from-the-app.md). ## Related - [Your profile and participant profiles](your-profile-and-participant-profiles.md) - [Registering for someone else](registering-for-someone-else.md) - [My competition registrations](my-competition-registrations.md) --- # Managing saved participant profiles URL: /en/joining-events/managing-saved-participant-profiles/ # Managing saved participant profiles Besides your own identity, DistantRace lets you save **other people** you register regularly — children, family members, or teammates. **Path:** Profile → **Participants** (`/accounts/participants/`) ## Your profile vs saved profiles | Profile | Who it is | |---------|-----------| | **Connected participant** | You — tied to your login, sports apps, and step sync | | **Saved profiles** | Other people you created or linked — used at checkout | ## Create a profile 1. Participants → **Add** 2. Enter name, birth date, gender, and contact fields 3. Save — the profile appears in the **Participant menu** during registration See [Registering for someone else](registering-for-someone-else.md) for the checkout flow. ## Edit a profile Open a saved profile you created to update name, birth date, or contact details. Changes propagate to future registrations; past event entries keep historical data unless the organizer edits them. You cannot edit another user's **connected** profile (someone with their own login) — only unlink it from your list. ## Link via share code If an organizer sent a **connect link**, opening it may add an existing participant profile to your account — [Linking a participant profile](linking-a-participant-profile.md). You can also accept a share link from the Participants page when `?linkcode=` is in the URL. ## Unlink a profile **Unlink** removes a profile from your Participant menu without deleting the person from events they already joined. Use when you no longer register that person but their history should stay intact. ## Delete a profile **Delete** is only available for profiles **you created** that do **not have their own login**. - If the person never registered for a paid or active event, the profile is **anonymized** and removed. - If they already have registrations or unpaid carts, delete is blocked — DistantRace **unlinks** only and shows a warning so orders and start lists stay correct. ## Related - [Your profile and participant profiles](your-profile-and-participant-profiles.md) - [Age restrictions and children](age-restrictions-and-children.md) - [Merging duplicate participants](../more-tools/merging-duplicate-participants.md) (organizer tool) --- # Managing your account settings URL: /en/joining-events/managing-your-account-settings/ # Managing your account settings Your DistantRace **account settings** cover login details, profile data, and security — separate from [saved participant profiles](managing-saved-participant-profiles.md) you use at checkout. **Path:** Log in → Profile / **Account** (`/accounts/`) ## Edit profile **Profile** (`/accounts/profile/`) — update your connected participant: - First and last name - Birth date and gender - Phone and address fields - Profile photo (upload JPG or PNG) Email on this form follows your account login address — change it under **Email** (below). ## Change email **Email** (`/accounts/email/`): 1. Add a new address if needed 2. Verify via the confirmation link DistantRace sends 3. Set the verified address as **primary** Your participant profile email updates when the primary login email changes. ## Change password **Password** (`/accounts/password/change/`) — set a new password when you signed up with email and password. Social-only accounts may use **Set password** first (`/accounts/password/set/`) to add a password alongside Google or Apple login. ## Connections (sports apps) **Connections** (`/accounts/social/`) — connect or disconnect Garmin, Polar, Fitbit, and other [supported apps](../connections-with-apps/supported-apps.md). See [Supported apps](../connections-with-apps/supported-apps.md) for setup guides and [Resolving duplicate social accounts](resolving-duplicate-social-accounts.md) if login conflicts appear. ## Security | Setting | Path | |---------|------| | **Two-factor authentication** | `/accounts/2fa/` — [Two-factor authentication](two-factor-authentication.md) | | **Passkey** | Account security — [Sign-in options](sign-in-options.md) | | **Notifications** | `/accounts/notifications/` — [Notification preferences](notification-preferences.md) | | **Daily steps** | `/accounts/daily_stats/` — [Daily steps on the website](daily-steps-on-the-website.md) | Organizers need 2FA enabled for [manager console](../running-events/access-the-organizer-console.md) access. ## Delete account **Delete account** (`/accounts/profile/delete/`) permanently removes your login. Read [Delete your account](delete-your-account.md) for prerequisites (withdraw from active events, unpaid carts). ## Related - [Your profile and participant profiles](your-profile-and-participant-profiles.md) - [Create an account](create-an-account.md) - [Sign-in options](sign-in-options.md) --- # Managing your activities URL: /en/joining-events/managing-your-activities/ # Managing your activities **Path:** Profile → **My workouts** (`/accounts/my_workouts/`) ## Activity list Shows synced workouts with sport type, date, distance, and whether each activity **counts** toward your events. Open an activity for map, splits, and inclusion details. ## Why an activity doesn't count DistantRace explains exclusions (wrong sport, outside date window, missing GPS, etc.). See [Why activities are missing](why-activities-are-missing.md). ## Manual sync by date Pull historical activities from connected apps for a date range you missed — useful after connecting Garmin or Polar mid-challenge. **Path:** My workouts → **Sync** (or activity list sync action) ## Upload a file When auto-sync is unavailable, upload **GPX, FIT, or TCX** files: 1. My workouts → **Upload** 2. Select file and sport type 3. Wait while the file **processes** — large imports show a progress counter until all activities are parsed 4. Activities appear in your list when processing completes **TCX** is common for Fitbit exports and some watch apps. See [Extracting activity files](../extracting-activity-files/index.md) for export instructions from other apps. ## Create a manual workout When an organizer enables **manual workout acceptance** on a challenge, you can log a workout without a GPS file: 1. My workouts → **Add activity** (or **Create manually** on the upload page) 2. Fill sport type, date, distance, and duration 3. Save — the activity processes like an uploaded file Organizers may need to approve it — [Advanced challenge settings](../running-events/advanced-challenge-settings.md). ## Activity detail actions Open any activity from the list to: - **Submit to event** — attach a private/synced workout to a specific challenge or competition you joined - **Remove from event** — stop counting this workout toward one challenge (does not delete the activity) - **Move to another challenge** — when you joined multiple events in the same club, reassign the workout from one challenge to another - **Assign to child registrations** — for [child subaccounts](registering-for-someone-else.md), tick which children's competition entries should use this parent-recorded activity - **Assign to child challengers** — same for step or sports challenges with subaccounts enabled - **Delete photos** attached to the activity Results recalculate in the background after submit, move, or remove actions. ## Edit or delete - **Edit** — change sport type or metadata when you picked the wrong category - **Delete** — removes the activity and recalculates challenge results Organizers may need to re-approve edited activities if [manual workout acceptance](../running-events/advanced-challenge-settings.md) is enabled. ## Unapproved activities If an organizer **manually rejected** a workout (when [manual workout acceptance](../running-events/advanced-challenge-settings.md) is enabled), the activity appears under **Unapproved** or shows a banner on the detail page with the organizer's reason. Contact the organizer through [Contact the organizer](contact-the-organizer.md) if you believe the activity should count. They can accept it from the challenge **Workouts** list. ## Related - [Connections with apps](../connections-with-apps/supported-apps.md) - [Participate in a challenge](participate-in-a-challenge.md) --- # Mobile app and step challenges URL: /en/joining-events/mobile-app-and-step-challenges/ # Mobile app and step challenges ## Step challenges require the app For **step challenges**, daily steps must reach DistantRace through the **mobile app**. Connecting Apple Health, Google Fit, Health Connect, or a step source is done in the app — not only on the website. See the [Mobile app](../mobile-app/index.md) section — especially [Step sync setup](../mobile-app/step-sync-setup.md) and [How to set up a step data source](../connections-with-apps/how-to-set-up-a-step-data-source-in-the-distantrace-app.md). ## Opening event links on mobile When you open a short event link on a phone, DistantRace may show a **mobile landing page** with: - Links to download the iOS or Android app - Option to continue on the web - For step challenges, a note that the app is needed for step sync ## Sports activity challenges Workout-based challenges do not always require the DistantRace app. You can connect Garmin, Polar, or other apps on the website and sync activities from there. ## Find events in the app Use the app to scan a QR code or enter a join code. See [Find an event in the app](find-an-event-in-the-app.md). ## Step game and message board Once registered, open the challenge on the website for **Step game** daily tasks and the full **Messages** feed. The mobile app **Posts** tab also shows message-board activity across your events — see [Challenge message board](challenge-message-board.md) and [Step game daily tasks](step-game-daily-tasks.md). ## Huawei devices Step sync from some Huawei devices may be limited. The onboarding page links to workaround guides where available. ## Related - [Mobile app](../mobile-app/index.md) - [Supported apps](../connections-with-apps/supported-apps.md) - [Challenge onboarding page](challenge-onboarding-page.md) --- # My competition registrations URL: /en/joining-events/my-competition-registrations/ # My competition registrations **Path:** Profile → **My events** → open a competition → your registration ## Registration detail Shows distance, team, bib number (when assigned), payment status, and custom answers you submitted. ## Change distance or team When the organizer allows self-service edits before the deadline: 1. Open your registration 2. Use **Change distance** or **Change team** 3. Confirm — price difference may require additional payment **Virtual competitions only:** **Change distance** is available for timed virtual races (not in-person real races). If you already **submitted a result**, changing distance **clears** that result and linked workouts — DistantRace reconnects qualifying activities afterward. If the button is missing, contact the organizer — see [Contact the organizer](contact-the-organizer.md). ## Anonymize on the start list From your registration detail, use **Anonymize** to hide your name on the public start list while keeping your entry active — [Viewing the start list](viewing-the-start-list.md). ## Edit participant details Update allowed fields (phone, emergency contact, etc.) while the edit window is open. ## Payment and invoice Link to the order in [My purchases and orders](my-purchases-and-orders.md) and [Downloading invoices and receipts](downloading-invoices-and-receipts.md). ## Transfer to another person When the organizer sells a **Participant Replacement** product, use **Replace participant** on this page — [Transferring your registration to someone else](transferring-your-registration-to-someone-else.md). ## Related - [Register for in-person competitions](register-for-in-person-competitions.md) - [Participate in virtual competitions](participate-in-virtual-competitions.md) --- # My purchases and orders URL: /en/joining-events/my-purchases-and-orders/ # My purchases and orders **My purchases** is your order history for paid and pending event registrations. **Path:** Log in → Profile → **My purchases** (`/accounts/my_purchases/`) ## What you see | Order status | Meaning | |--------------|---------| | **New** | Cart started but checkout not finished — continue payment | | **Waiting payment** | Bank transfer invoice issued — awaiting your payment | | **Payment received** | Paid — you are registered (or registration processing is complete) | | **Dynamic** | Shared registration cart — see [Joining via dynamic cart link](joining-via-dynamic-cart-link.md) | ## Order detail page Open an order to see: - Organizer contact details - Billing information - Participants and distances (or products) - **Download invoice** button (when available) - **Get tickets** — PDF tickets for in-person races (after payment) - **Add products** — buy post-registration add-ons if the organizer enabled them ## Continue an unfinished registration If status is **New** or **Waiting payment** (non-bank-transfer), click **Continue to payment** to return to checkout. ## Cancel an order Unpaid orders can be cancelled from the order detail page. Cancelled carts cannot be restored — start registration again if needed. ## Create a group registration cart (dynamic cart) Paying for a team or company group? Create a **dynamic cart** and share one link so each person registers themselves into your checkout. **Path:** My purchases → **Create dynamic cart** 1. Enter a **description** (e.g. "Company ABC team") so you recognize the order later 2. Pick the **competition** 3. Optionally preset a **team** — select an existing team or create a new public team everyone joining through the link will use 4. Enable **Other events** when the club runs several races on the same day and participants should pick additional distances in one shared cart 5. Submit — you land on the dynamic cart order page with a **shareable registration link** ### Manage the cart before payment From the dynamic cart order detail: - **Share the link** — send the apply URL to colleagues; each person adds their own entry - **Remove item** — delete a participant row before checkout if someone registered by mistake - **Cancel** — abandon the whole cart if you no longer need it When everyone has registered, pay once from the cart detail page. See [Joining via dynamic cart link](joining-via-dynamic-cart-link.md) for the participant side. ## Without an account If you checked out as a guest, use the **Order summary** link on the checkout confirmation page. You can view the order and download the invoice from that public link. ## Related - [Downloading invoices and receipts](downloading-invoices-and-receipts.md) - [Register for in-person competitions](register-for-in-person-competitions.md) --- # Notification preferences URL: /en/joining-events/notification-preferences/ # Notification preferences **Path:** Profile → **Notifications** (`/accounts/notifications/`) ## What you can control - DistantRace system emails (account, security) - Event-related messages from organizers you joined - Marketing opt-in/out per club (where collected at registration) ## Unsubscribe links Marketing emails include an **unsubscribe** link valid for that campaign or club. One-click unsubscribe does not delete your account. ## Challenge daily emails Step challenges may send **daily summary emails**. Organizers can disable these globally — you cannot override if the organizer turned them off. ## Related - [Marketing preferences on registration](../running-events/marketing-preferences-on-registration.md) - [Delete your account](delete-your-account.md) --- # Participate in a challenge URL: /en/joining-events/participate-in-a-challenge/ # Participate in a challenge Challenges are multi-day events where steps or sports activities sync automatically. Follow these steps to join. ## 1. Create an account Create a [DistantRace account](create-an-account.md) if you do not have one. ## 2. Install the app (recommended) Install the [DistantRace app](https://distantrace.com/app). It is **required for step challenges** and helpful for finding private events via QR code. ## 3. Connect a sports app or step source Connect Garmin, Polar, Fitbit, or another [supported app](../connections-with-apps/supported-apps.md). For daily steps, set up a step source in the mobile app. ## 4. Find the challenge - Browse [public events](https://distantrace.com/en/events/), or - Open the private link or QR code from the organizer, or - Enter a [join code](using-a-join-code.md) See the [challenge onboarding page](challenge-onboarding-page.md) if the organizer shared one. ## 5. Register 1. Open the challenge and click **Register**. 2. If the event is private, enter your join code first. 3. Fill in the registration form (custom questions, team, distance if shown). 4. Submit — you appear on the participant list. ### Multiple distances Some challenges let you enroll in **more than one distance** (for example 5 km and 10 km categories). Select each distance you want on the form. ### Teams Pick or create a team if the form includes a team question. See [Joining a team](joining-a-team.md). ### Premium packages Some challenges offer optional paid add-ons after registration. You are redirected to checkout if you select them. ## 6. Record activities Exercise as usual. Steps and workouts sync to DistantRace automatically from your connected services. ## 7. Follow results Open **Results** or **My result** on the challenge page. See [After joining a challenge](after-joining-a-challenge.md). ## Troubleshooting - Missing activities? [Why activities are missing](why-activities-are-missing.md) - Private event? [Using a join code](using-a-join-code.md) --- # Participate in virtual competitions URL: /en/joining-events/participate-in-virtual-competitions/ # Participate in virtual competitions Virtual competitions are timed races over a set distance. You register, record one GPS-tracked workout, and DistantRace calculates your time to complete the distance. ## Registration 1. [Create an account](create-an-account.md) if needed. 2. Connect a sports app under [Connections](https://distantrace.com/en/accounts/social/) — use a [supported app](../connections-with-apps/supported-apps.md) with GPS. 3. Find the competition on [public events](https://distantrace.com/en/events/) or via the organizer's link. 4. Click **Registration** and complete the form. 5. If there is a fee, complete [checkout](register-for-in-person-competitions.md) — free events confirm immediately. Some virtual competitions use a simplified **express registration** form (single page) — [Express registration](express-registration.md). Paid events redirect to the payment flow before you are fully registered. Private events may require a [join code](using-a-join-code.md) first. ## Recording your activity 1. **Enable GPS** on your phone or watch before starting. 2. **Start** the activity in your sports app and complete at least the required distance. 3. You may continue past the distance; only time to the target distance counts. 4. **Save** the activity — it syncs to DistantRace. For **distant race** and **challenge race** formats you may need to **pick which workout counts** and **finalize** your result — see [Selecting your virtual race workout](selecting-your-virtual-race-workout.md). Other virtual formats calculate automatically from the first valid sync. ::: tip Breaks count Pause time is included in your result, similar to a real race — from start until you reach the required distance. ::: ## Results Results appear after sync (and after you submit/finalize a workout if required). Check the competition [results and standings](viewing-competition-standings-and-team-results.md). Processing may take a few minutes. ## Related - [Selecting your virtual race workout](selecting-your-virtual-race-workout.md) - [Viewing competition course maps](viewing-competition-course-maps.md) — when the organizer published GPX routes - [Express registration](express-registration.md) - [Which type of event is this?](which-type-of-event-is-this.md) - [Supported apps](../connections-with-apps/supported-apps.md) --- # Personal activity exclusion zones URL: /en/joining-events/personal-activity-exclusion-zones/ # Personal activity exclusion zones **My locations** lets you mark areas on a map where activities should **not** count — for example a gym, commute corridor, or treadmill room where GPS drift could wrongly include distance. **Path:** Profile → **My locations** — [distantrace.com/en/accounts/my_locations/](https://distantrace.com/en/accounts/my_locations/) ## Create a zone 1. Open **My locations** and click **Create new**. 2. Draw a polygon on the map around the area to exclude. 3. Give the zone a **title** and save. Zones are stored on your account and apply to future activity processing. ## Enable or disable Each saved location can be **enabled** or **disabled** without deleting it — useful when you travel or temporarily want all activities counted. ## Delete a zone Remove locations you no longer need from the list actions. ## How exclusions work When DistantRace processes your synced workouts, activities recorded **inside** your exclusion zones may be filtered out according to challenge rules. Exclusion zones help when: - Indoor treadmill runs pick up GPS noise - A regular commute segment should not count toward a virtual race - You train at a fixed loop the organizer treats as invalid Challenge-specific [geo restrictions](../running-events/geo-location-restrictions.md) from organizers are separate from your personal zones. ## Related - [Managing your activities](managing-your-activities.md) - [Why activities are missing](why-activities-are-missing.md) - [Geo challenge maps](geo-challenge-maps.md) --- # Picking a start time slot URL: /en/joining-events/picking-a-start-time-slot/ # Picking a start time slot Some in-person races divide starts into **time slots** (waves) to reduce crowding at the start line. ## When this applies The organizer enables time slots on the competition. After you register and pay, you may be asked to pick a slot — or you can open the time slot page from your event dashboard. ## Pick a slot 1. Open the competition's **Time slots** page (linked from event info or confirmation email) 2. Choose a date (multi-day events) 3. Select an available slot — full slots are greyed out 4. Confirm — your slot is saved to your registration ## Change or cancel a slot Return to the time slots page while registration is open. You can switch to another free slot or release yours. ## Limits Each slot has a maximum capacity set by the organizer. Slots are first-come, first-served. ## Related - [Register for in-person competitions](register-for-in-person-competitions.md) - [After joining a challenge](after-joining-a-challenge.md) — finding your event dashboard --- # Post-registration add-ons URL: /en/joining-events/post-registration-add-ons/ # Post-registration add-ons Some events let you **buy add-on products after** completing registration — t-shirts, medals, donations, etc. ## When available - **Immediately after registration** — the confirmation page may offer [premium packages](../running-events/premium-registration-packages.md) or extra questions (`apply/ok/`) - **Later by email** — **Add products** on your [order detail](my-purchases-and-orders.md) page while the product window is open ## Checkout 1. Open My purchases → your order → **Add products** 2. Select items and variations (size, color) 3. Pay the additional amount (or confirm free add-ons) Initial checkout add-ons are covered in [Checkout add-ons and shipping](checkout-add-ons-and-shipping.md). ## Related - [Upsell products in checkout](../running-events/upsell-products-in-checkout.md) - [Downloading invoices and receipts](downloading-invoices-and-receipts.md) --- # Race-day registration as a participant URL: /en/joining-events/race-day-registration-as-a-participant/ # Race-day registration as a participant When online registration closes, organizers may still accept **race-day entries** via QR code. ## Steps 1. Open the same event registration link (from an email or the organizer's website) 2. Register **one person at a time** — fill the shortened form 3. After submit, a **QR code** appears on screen and is emailed to you 4. At the venue, staff scan the QR, confirm payment, and assign your bib Organizer setup: [Race-day registration and check-in](../running-events/race-day-registration-and-check-in.md). ## Payment on site If the organizer charges a race-day fee, pay at the registration tent — they record payment in the console. ## Related - [Register for in-person competitions](register-for-in-person-competitions.md) - [Picking a start time slot](picking-a-start-time-slot.md) --- # Register for in-person competitions URL: /en/joining-events/register-for-in-person-competitions/ # Register for in-person competitions DistantRace also allows organizers to run in-person competitions through the DistantRace platform. Publicly available competitions can be found here: , but there may also be competitions that can only be found via a link sent by the organizer. 1. Press "Register". ![](/static/img/real-race-management/how-to-register-for-in-person-competitions/image-1712644188469-28-41.jpg) 2. Choose your participation "ticket" by pressing "+". Pay attention to the distance name and birth years. If the organizer runs several sports events, it is also possible to register for several competitions at once — press "Other events". Once everything is selected, press "Proceed to payment". ![](/static/img/real-race-management/how-to-register-for-in-person-competitions/image-1712644342893-31-50.png) 3. The registration form is divided into 3 parts: - Payer information - Participant information - Email and marketing settings Payer information. If the payer is a private person, enter the name, surname, and email (it is filled in automatically if a registered distantrace.com user is registering). If you need an invoice with company details, press "Invoice needed for a company". If you need to hide participant names on the invoice, choose "Hide participant names on the invoice". ![](/static/img/real-race-management/how-to-register-for-in-person-competitions/image-1712644606394-35-58.png) Participant information. Press the "down" arrow to open the participant form. ![](/static/img/real-race-management/how-to-register-for-in-person-competitions/image-1712644715334-37-54.png) The form can differ for each competition — the organizer can add or remove questions. If the participant has registered on distantrace.com and is logged in, it is possible to choose a participant from the "Participant menu" — it will show all participants previously registered with this DistantRace account. ![](/static/img/real-race-management/how-to-register-for-in-person-competitions/image-1712644821308-38-55.png) Email and marketing settings. Here you can tick your preferences. The preferences are passed to the organizer, and it is the organizer who decides whether or not to contact the participant. For example, even if you tick nothing here, the organizer may still email you information about the competitions you have registered for. ![](/static/img/real-race-management/how-to-register-for-in-person-competitions/image-1712644942000-40-42.png) Once everything is filled in, press "Go to payment". 4. Order summary In the order summary, you can review the cart totals, add a discount code (if the organizer has defined one for the competition), and choose the payment method. Each organizer can define their own payment methods, so this section differs from organizer to organizer. **Group discount:** registering several participants in one checkout may trigger an automatic **bulk discount** when the organizer configured one — no coupon code needed. See organizer guide [Bulk registration discounts](../finance-module/bulk-registration-discounts.md). For **invoices** — company billing, bank transfer prepay invoices, and downloading PDFs after payment — see [Downloading invoices and receipts](downloading-invoices-and-receipts.md). ![](/static/img/real-race-management/how-to-register-for-in-person-competitions/image-1712645056940-43-20.png) 5. After registering for the competition, you will receive a confirmation email from DistantRace or the organizer. ## After registration - [Viewing competition course maps](viewing-competition-course-maps.md) — GPX routes, checkpoints, and downloadable tracks - [Viewing the start list](viewing-the-start-list.md) - [Picking a start time slot](picking-a-start-time-slot.md) - [My competition registrations](my-competition-registrations.md) --- # Registering for someone else URL: /en/joining-events/registering-for-someone-else/ # Registering for someone else You can register **other people** from your DistantRace account using **sub-accounts** (linked participant profiles). This is common for parents registering children or one person signing up a group. ## When to use sub-accounts - Registering a child under 13 (see [Age restrictions and children](age-restrictions-and-children.md)) - One account paying for multiple family members - Applying to a challenge on behalf of someone who does not have their own login ## How it works 1. Log in to your DistantRace account. 2. Open the event registration form. 3. Choose **another participant** from your saved profiles, or create a new sub-account with their name and birth date. 4. Complete the form and submit. Activities for challenges still sync through **connected apps on the account that records them** — typically the person who actually wears the device. For virtual competitions and challenges with **child subaccounts**, open the activity on **My workouts** and assign it to each child's registration — [Managing your activities](managing-your-activities.md). ::: warning Children under 13 Children under 13 cannot have their own DistantRace login. Parents create a sub-account and connect activities from the parent's devices or accounts as appropriate. ::: ## Challenges vs competitions - **Challenges:** sub-account apply is available from the challenge apply form. - **In-person / virtual competitions:** during checkout you can add multiple participants under one payer, or pick saved profiles if logged in. ## Related - [Age restrictions and children](age-restrictions-and-children.md) - [Joining via dynamic cart link](joining-via-dynamic-cart-link.md) --- # Registering interest before signup URL: /en/joining-events/registering-interest-before-signup/ # Registering interest before signup Some events let you leave your **email** before you have a DistantRace account or before registration opens. You are added to the organizer's **interested** list and guided to sign up or log in. ## When you see this - Registration is **not open** yet but the event page accepts interest - You must **create an account** or **log in** before the apply form appears - A private event preview asks for your email first ## What happens 1. Enter your email on the event or challenge page. 2. DistantRace saves you as **interested** for that event (and club). 3. You are redirected to **Sign up** or **Log in** with your email pre-filled. 4. After creating an account, the event may appear in onboarding — [Getting started after signup](getting-started-after-signup.md). When you complete registration, your interest entry is marked as applied automatically. ## After you have an account Return to the event link from the organizer and finish [registration](which-type-of-event-is-this.md). Your earlier interest does not replace signing up — it only captures contact details and helps organizers plan capacity. ## Organizer side Clubs see interested emails in the manager console — [Collecting interested participants](../running-events/collecting-interested-participants.md). ## Related - [Create an account](create-an-account.md) - [Email invitation links](email-invitation-links.md) --- # Resolving duplicate social accounts URL: /en/joining-events/resolving-duplicate-social-accounts/ # Resolving duplicate social accounts When you connect **Google**, **Apple**, or **Facebook** to DistantRace, the platform may detect that this social login already belongs to **another DistantRace account**. You are redirected to a **duplicate accounts** page to resolve the conflict. **URL pattern:** `/accounts/social/double_accounts////` ## Why this happens - You previously signed up with email, then tried social login with the same identity - You created separate accounts on phone and desktop - A family member used your device to log in once See also [Multiple DistantRace user accounts](../connections-with-apps/data-synchronization-problems/multiple-distantrace-user-accounts.md) for email-based duplicates. ## Switch accounts **Switch** moves the social connection to your **current** logged-in account. Use this when: - The social login has the activities you want - The other account was created by mistake and is empty After switching, connect sports apps again on the account you keep. ## Request merge **Merge** sends a request to DistantRace support to combine two full accounts (registrations, history, payments). Use when **both** accounts contain data you need. Support may verify ownership via email before merging. ::: note Time limit The duplicate-accounts page is available for a limited time after the conflict is detected. If it expires, reconnect the social app or contact support@distantrace.com. ::: ## Prevent duplicates - Use one email everywhere — [Getting started after signup](getting-started-after-signup.md) - Log in on phone and web with the same method - Before connecting a new social app, check which email is on your [profile](your-profile-and-participant-profiles.md) ## Related - [Sign-in options](sign-in-options.md) - [Delete your account](delete-your-account.md) --- # Selecting your virtual race workout URL: /en/joining-events/selecting-your-virtual-race-workout/ # Selecting your virtual race workout For some virtual competitions, syncing a workout is not enough — you must **choose** which activity counts and optionally **finalize** your result so it cannot be changed. ## When this applies **Distant race** and **challenge race** style virtual competitions show a **My workouts** page after you register. If your competition calculates the result automatically from the first valid sync, you may not see this step — check the event instructions. ## Open your workouts 1. Log in and go to [My competitions](https://distantrace.com/en/accounts/competitions/) (or the competition page → your entry). 2. Open **My workouts** for your registration. 3. DistantRace lists GPS activities that match the competition rules (distance, date window, sport type). Only activities with **OK** status appear. ## Submit an activity 1. Review elapsed time and distance for each row. 2. Click **Submit** on the workout you want as your official result. 3. DistantRace calculates your time to the required distance and updates standings. ::: tip Competition still open You can change your submitted workout while the competition is **open** and the result is not yet finalized. ::: ## Finalize your result When you are satisfied, click **Submit as final** (finalize). After finalization: - Your result is locked - You cannot pick a different workout - The organizer and public results use this time Finalize only after you are sure no better activity will sync. ## Common issues | Problem | What to do | |---------|------------| | No workouts listed | Wait for sync; check [Supported apps](../connections-with-apps/supported-apps.md) and [Managing your activities](managing-your-activities.md) | | Cannot submit | Competition may have ended — see `result_submit_after_end` message | | Overlapping activity used elsewhere | Another entry already finalized an overlapping GPS track | | Wrong account | Activities synced to a different DistantRace profile | ## Related - [Participate in virtual competitions](participate-in-virtual-competitions.md) - [Comparing virtual race results](comparing-virtual-race-results.md) - [Why activities are missing](why-activities-are-missing.md) --- # Sign-in options URL: /en/joining-events/sign-in-options/ # Sign-in options DistantRace supports several ways to access your account. ## Email and password Standard login at [distantrace.com/login](https://distantrace.com) with the email you used when you [created an account](create-an-account.md). ## Login code by email Request a **one-time code** sent to your inbox — useful on shared devices without saving a password. ## Passkey (WebAuthn) Register a **passkey** on supported browsers for passwordless login with Face ID, Touch ID, or device PIN. **Path:** Account settings → Security → Add passkey ## Social login Sign in with **Google**, **Apple**, or **Facebook** if you linked them under [Connections](../connections-with-apps/supported-apps.md). ## Mobile app QR login Scan a QR code on the website with the DistantRace app to log in the browser session — see [Installation and sign-in](../mobile-app/installation-and-sign-in.md#qr-login-to-the-website) and [Finding and joining events](../mobile-app/finding-and-joining-events.md). ## Enterprise SSO and whitelabel Whitelabel and corporate clubs use **SAML single sign-on** (Microsoft and other IdPs) or OAuth through a branded portal — [Enterprise SAML and whitelabel login](enterprise-saml-and-whitelabel-login.md). Organizer setup: [Whitelabel and enterprise setup](../running-events/whitelabel-and-enterprise-setup.md). ## Two-factor authentication (2FA) Required for [organizer console](../running-events/access-the-organizer-console.md) access. Set up authenticator app, phone, or recovery codes — [Two-factor authentication](two-factor-authentication.md). ## Related - [Two-factor authentication](two-factor-authentication.md) - [Resolving duplicate social accounts](resolving-duplicate-social-accounts.md) - [Your profile and participant profiles](your-profile-and-participant-profiles.md) --- # Step game daily tasks URL: /en/joining-events/step-game-daily-tasks/ # Step game daily tasks In **step** and **combined** challenges, the **Step game** tab shows a sequence of daily tasks (goals) you unlock one after another. **Path:** Challenge page → **Step game** (`/challenges//step_game/`) Organizers configure tasks in the manager — see [Step game](../running-events/step-game.md). If the tab is missing, the organizer may have hidden it or not set up goals yet. ## How it works 1. Tasks appear in **order** — complete the current task before the next one unlocks. 2. Only **one goal per calendar day** counts toward progress (based on your timezone). 3. Each task has a **target** — not only step counts, but also streaks, rest days, and message-board actions (see below). 4. Progress updates when DistantRace receives your [daily steps](daily-steps-on-the-website.md), qualifying activities, or message-board activity. 5. Completed goals show a **points** badge when the organizer assigned points. If challenge scoring includes a **step game task** rule, those points also feed the main leaderboard. ## Goal types you may see Organizers pick from preset goal kinds, for example: | Kind | What you need to do | |------|---------------------| | Step amount | Reach a daily step target | | Consecutive days | Stay active on multiple days in a row | | Morning boost | Hit an early-day step threshold | | Increase vs yesterday / beat average / beat best | Beat your own recent stats | | Rest day | Take a planned recovery day | | First sync | Connect and sync data for the first time | | Post message / post image | Publish on the [challenge message board](challenge-message-board.md) | Post and image goals are common on private challenges; public events often skip them unless the organizer enables them. ## Your progress view When you are **registered** for the challenge, the page highlights: - **Current goal** — what you need to do now, with a progress bar when the goal is active today - **Opens tomorrow** — the next goal is unlocked in sequence but not yet active for today - **Done** — earlier goals with the date you completed them - **Locked** — future goals you have not reached yet - **Champions** — participants who finished the **final** goal in the sequence If the challenge has ended, is not open yet, or today's goal is not active, you may see your last completed goal instead of a live progress bar. If you browse without registering, you can read the goal list and rules but not personal progress or the champions list. ## Empty or completed states - **No goals configured** — the page shows that the Step game is currently unavailable; contact the organizer if you expected tasks. - **All goals done** — a **Step game completed** message appears; you remain on the champions list if applicable. Tap a completed goal to open the **Achievements** list filtered to that goal and see how many participants finished it. ## Tips - Connect a reliable step source before the challenge starts — [Supported apps](../connections-with-apps/supported-apps.md) and [Mobile app and step challenges](mobile-app-and-step-challenges.md) - Open **My result** to see overall standings alongside step game progress - Missing steps? See [Why activities are missing](why-activities-are-missing.md) ## Related - [After joining a challenge](after-joining-a-challenge.md) - [Mobile app and step challenges](mobile-app-and-step-challenges.md) - [Participate in a challenge](participate-in-a-challenge.md) --- # Transferring your registration to someone else URL: /en/joining-events/transferring-your-registration-to-someone-else/ # Transferring your registration to someone else If you cannot start a race but the organizer allows transfers, you can **replace yourself** with another person on the same registration slot. ## When transfer is available The organizer must publish a **Participant Replacement** product for the event — see [Upsell products in checkout](../running-events/upsell-products-in-checkout.md). If no transfer option appears, contact the organizer — [Contact the organizer](contact-the-organizer.md). Transfers are usually limited to a date before the race and may charge a **replacement fee**. ## How to transfer 1. Open **My events** → your competition → registration detail — [My competition registrations](my-competition-registrations.md) 2. Choose **Replace participant** (or open the replacement flow from your order) 3. Enter the **new participant's** details (name, birth date, gender, contact fields) 4. Pay the replacement fee if the product has a price — [My purchases and orders](my-purchases-and-orders.md) 5. Confirm — the new person takes your bib, distance, and answers; your name leaves the start list If the replacement is **free**, the swap completes immediately after you submit the form. ## What changes | Item | After transfer | |------|----------------| | Start list name | New participant | | Bib number | Usually kept on the same slot (may reset if auto-assignment rules apply) | | Distance / team | Unchanged unless you also bought a distance change | | Original payer | Unchanged — refunds are organizer policy | The new participant does **not** need your login. They may create their own account later and [link a participant profile](linking-a-participant-profile.md) if the organizer sends a connect link. ## Related - [Withdraw from an event](withdraw-from-an-event.md) — when you want a refund instead of a transfer - [Registering for someone else](registering-for-someone-else.md) — registering family at signup, not mid-season transfer --- # Two-factor authentication URL: /en/joining-events/two-factor-authentication/ # Two-factor authentication **Two-factor authentication (2FA)** adds a second check when you log in. It is **optional for participants** but **required for organizer console access**. **Path:** [Account → Two-factor authentication](https://distantrace.com/en/accounts/2fa/) — also linked from [Profile](https://distantrace.com/en/accounts/profile/) as **Manage two-factor authentication**. ## Why enable 2FA - Protects your profile, registrations, and payment history - **Required** to use the [organizer console](../running-events/access-the-organizer-console.md) after the grace period (see below) You can register for and participate in events without 2FA. Only organizer and admin areas enforce it. ## Setup options | Method | How it works | |--------|----------------| | **Authenticator app (TOTP)** | Scan a QR code with Google Authenticator, Authy, or similar | | **Phone (SMS)** | Verify your number once, then receive login codes by text (Twilio Verify) | | **Recovery codes** | One-time backup codes if you lose your device — generate from `/accounts/2fa/recovery-codes/` | | **Passkey** | Separate from the 2FA page — see [Sign-in options](sign-in-options.md) for passkey login | Follow the on-screen steps at `/accounts/2fa/` to activate your preferred method. Phone setup may pre-fill the number from your participant profile. ## Logging in with 2FA After email/password (or social login), DistantRace prompts for your second factor at `/accounts/2fa/authenticate/` — app code, SMS, or recovery code. If **only SMS** is configured, DistantRace sends a code automatically when the authenticate page loads. The page shows a masked phone number (for example `+371***12`). ## Recovery codes Generate and **download recovery codes** when you set up 2FA. Store them offline. Each code works once if you cannot access your phone or authenticator app. ## Organizers If you manage events, enable 2FA before console access is blocked: 1. After your **first event** is created, you get a **7-day grace period** — the console still works, but a banner shows days remaining and links to 2FA setup. 2. After grace expires, manager pages (except the event picker landing) are blocked until 2FA is enabled. The block message reads: *Please enable Two-Factor Authentication if you want to continue to use console views.* ## Related - [Sign-in options](sign-in-options.md) - [Delete your account](delete-your-account.md) --- # Using a join code URL: /en/joining-events/using-a-join-code/ # Using a join code Private and unlisted events on DistantRace may require a **join code** (also called a join password) before you can register. ## When you need a code - The event is set to **Private** or **Unlisted** with individual passwords - The organizer sent you a personal code or QR code - The event page redirects you to a code-entry screen ## Enter a code on the web 1. Open the event link from the organizer. 2. If prompted, enter your **join code** on the code-entry page. 3. After validation, you are redirected to the registration form for that event. ::: tip Code validity A valid code is remembered for about 15 minutes in your browser session. If registration takes longer, you may need to enter the code again. ::: ## Apply with a code during registration On some events you can also enter a code in the registration form itself. The code may: - Unlock access to a private event - Pre-select a **distance** if the code is tied to one - Pre-fill your name or email if the organizer set those on the code ## One code per participant **Individual join codes** can only be used by one DistantRace account. After you register with a code, that code is linked to your account. ## Join codes in the mobile app In the DistantRace app you can find events by scanning a QR code or entering a code. See [Find an event in the app](find-an-event-in-the-app.md). ## Organizer side Organizers create and distribute codes from the manager console. See [Join codes and invitations](../running-events/join-codes-and-invitations.md). ## Related - [Email invitation links](email-invitation-links.md) — one-click join from email - [Challenge onboarding page](challenge-onboarding-page.md) — organizer instructions with QR and links --- # Using a reserved entry link URL: /en/joining-events/using-a-reserved-entry-link/ # Using a reserved entry link Organizers send **reserved entry links** to partners, sponsors, or invited groups with pre-configured discounts or free slots. ## Open the link The URL looks like a normal registration page but may show: - Discounted or free pricing - Limited distance choices - Shortened form fields ## Complete registration Follow the standard checkout flow. Payment depends on the reserved entry rules (free, fixed price, or percentage discount). Organizer setup: [Reserved entries](../running-events/reserved-entries.md). ## Problems If the link says expired or full, contact the organizer — entry quotas are limited. ## Related - [Partner and corporate registration](../running-events/partner-and-corporate-registration.md) - [Register for in-person competitions](register-for-in-person-competitions.md) --- # Viewing competition course maps URL: /en/joining-events/viewing-competition-course-maps/ # Viewing competition course maps In-person, virtual, distant, and challenge-race competitions can publish **course maps** — GPX tracks, aid stations, and static map images. **Path:** Competition page → **Maps** (`/competitions//maps/`) The **Maps** tab appears only when the organizer uploaded at least one route or map image. It is hidden for **collection** and **ticket-only** event types. ## Access and private events For **private** events or events that require a [join code](using-a-join-code.md): - If the organizer set **login required to register**, you must be signed in and registered (or have entered a valid join code) before maps load. Otherwise DistantRace redirects you to the join page. - If login is **not** required to register, maps stay visible to everyone even before you sign up. ## Interactive map The maps page overlays organizer-uploaded **GPX routes** on an interactive map (Leaflet). Multiple distances may show in **different colors** — use the route buttons to show or hide each layer. Zoom and pan to inspect the course. **Checkpoints and points of interest** appear as markers when the organizer added them — aid stations, turn points, start/finish areas. Tap a marker for the name, description, and optional photo. For standard distance GPX files, **start** and **finish** markers appear at the ends of the track. At higher zoom levels, **kilometre markers** appear along the route. Each route may also offer: - **Download GPX** — save the file to your device or watch - Links to open the route in **Garmin**, **Strava**, or **Under Armour** (when the organizer enabled them) If no routes are published yet, the page shows that no tracks are currently uploaded. ## Static map images Some events also attach **map images** (course diagrams or elevation profiles) below the interactive map. Click a thumbnail to open the full image. ## Before race day Use maps to: - Study the route and elevation - Plan pacing for each segment - Find spectator access points - Load the GPX onto your watch for navigation practice Maps reflect what the organizer published — always follow official race briefings on race day for last-minute changes. ## Related - [Viewing the start list](viewing-the-start-list.md) - [Register for in-person competitions](register-for-in-person-competitions.md) - [Participate in virtual competitions](participate-in-virtual-competitions.md) --- # Viewing competition standings and team results URL: /en/joining-events/viewing-competition-standings-and-team-results/ # Viewing competition standings and team results After organizers publish results, the public competition site shows more than a flat finish list — **standings**, **age groups**, and **team** tables may be available. ## Overall results The main **Results** tab lists finishers by distance — times, status (finished, DNF, DNS), and position. Filter or search if the organizer enabled it. ## Standings Many events add **Standings** — series points, age-group rankings, or multi-race totals. **Path:** Competition page → **Standings** Standings types depend on organizer configuration: - Overall series points across distances - Gender or age-group tables - Custom groupings (club, corporate team, region) ## Team results Team competitions show a **Team results** tab with combined scores. **Path:** Competition page → **Team results** (or **Results → Teams**) Each row aggregates member performances according to the event's team scoring rules. ## Virtual vs in-person | Type | What you see | |------|----------------| | **In-person** | Chip times, gun times, splits | | **Virtual** | GPS-derived times after you [select a workout](selecting-your-virtual-race-workout.md) | | **Series / season pass** | Per-stage results plus combined standings | ## Compare with others Use [Comparing virtual race results](comparing-virtual-race-results.md) for side-by-side virtual race analysis. Standings show official published positions only. ## Related - [Viewing your race result](viewing-your-race-result.md) - [Viewing the start list](viewing-the-start-list.md) - [Downloading diplomas and certificates](downloading-diplomas-and-certificates.md) --- # Viewing the start list URL: /en/joining-events/viewing-the-start-list/ # Viewing the start list Published competitions show a **Start list** tab on the public event page. ## Find yourself Search by name or bib number (when assigned). The list shows distance, team, and country if the organizer publishes these fields. ## Privacy Organizers control which columns are public. Some events hide birth year or contact details. ## Anonymize your name From [My competition registrations](my-competition-registrations.md), open your entry and use **Anonymize** to hide your name on the public start list while keeping your registration active. Organizer view: [Managing the start list](../running-events/managing-the-start-list.md). ## Related - [My competition registrations](my-competition-registrations.md) - [Register for in-person competitions](register-for-in-person-competitions.md) --- # Viewing your race result URL: /en/joining-events/viewing-your-race-result/ # Viewing your race result Each published finisher has an individual **result detail** page with time, status, and optional map and diploma. ## Open your result 1. Go to the competition on the public site. 2. Open **Results** and find your name, or use the link from a result notification email. 3. Click your row to open the **result detail** page. From [My competition registrations](my-competition-registrations.md) you can jump to the competition, then find your result in the list. ## What the page shows | Section | Content | |---------|---------| | **Time** | Chip time, gun time, or virtual GPS time | | **Status** | Finished, DNF, DNS, DSQ | | **Distance / category** | Which distance and group you competed in | | **Map** | GPS route for virtual results or GPS-tracked in-person races | | **Splits / laps** | Intermediate times on multi-lap courses | | **Nearby finishers** | Athletes who finished close to your time | | **Diploma** | Finisher image when generated — [Downloading diplomas](downloading-diplomas-and-certificates.md) | | **Share** | Link for social sharing (share mode may hide some details) | ## Virtual races Your result appears after you [submit a workout](selecting-your-virtual-race-workout.md). Until then the results list may show you as registered without a time. ## Privacy If you [anonymized your name](viewing-the-start-list.md) on the start list, the public result may still show your time depending on organizer settings. Contact the [organizer](contact-the-organizer.md) for privacy requests. ## Related - [Viewing competition standings and team results](viewing-competition-standings-and-team-results.md) - [Comparing virtual race results](comparing-virtual-race-results.md) --- # Virtual map progress URL: /en/joining-events/virtual-map-progress/ # Virtual map progress Challenges with a **virtual map** show collective progress along a GPX route — like walking a virtual trail together. ## View the map Open the challenge **Results** or **Map** tab on the public event page. Your avatar or team marker moves as distance/steps accumulate. ## Individual vs team progress - **Individual challenges** — your own progress along the path - **Team challenges** — combined team distance determines marker position Organizer setup: [Challenge default virtual paths](../running-events/challenge-default-virtual-paths.md) and [Virtual map settings](../running-events/challenge-settings-reference.md#virtual-map). ## Milestones [Goals and milestones](../running-events/challenge-goals-and-milestones.md) may unlock badges when the group reaches points on the map. ## Related - [After joining a challenge](after-joining-a-challenge.md) - [Geo challenge maps](geo-challenge-maps.md) --- # Which type of event is this? URL: /en/joining-events/which-type-of-event-is-this/ # Which type of event is this? DistantRace hosts several event types. The registration and activity-recording steps differ, so identify your event type first. ## Step and sports activity challenges **Challenges** run over days or weeks. You register once, then activities or steps sync automatically during the event window. | Kind | What counts | Example | |------|-------------|---------| | Step challenge | Daily steps from phone or watch | 10,000 steps per day for 30 days | | Running / cycling challenge | Distance from sports app workouts | Run 100 km in a month | | Active days challenge | Days with enough activity time | 20 active days in 4 weeks | | Combined / points challenge | Steps plus workouts, or points per km | Corporate wellness program | **How to join:** [Participate in a challenge](participate-in-a-challenge.md) ## Virtual competitions **Virtual competitions** are timed efforts over a fixed distance — for example, run 5 km as fast as you can within the event dates. You record one GPS-tracked workout; DistantRace calculates your time to complete the required distance. **How to join:** [Participate in virtual competitions](participate-in-virtual-competitions.md) ## In-person races **In-person races** use ticket-based registration. You choose a distance, fill in participant details, and pay online (or on race day if the organizer allows it). You receive a confirmation and appear on the start list. **How to join:** [Register for in-person competitions](register-for-in-person-competitions.md) ## Private events Some events are **unlisted** or **private**. You need a link from the organizer and sometimes a [join code](using-a-join-code.md) or [email invitation](email-invitation-links.md). ## Quick comparison | | Challenge | Virtual competition | In-person race | |---|-----------|---------------------|----------------| | Duration | Multi-day window | Single effort in window | Fixed race day | | Registration | Apply form | Apply or ticket flow | Tickets + payment | | Activity | Ongoing sync | One GPS workout | Physical participation | | Results | Live leaderboard | Time to distance | Timing / start list | --- # Why activities are missing URL: /en/joining-events/why-activities-are-missing/ # Why activities are missing If you notice that one of your activities is not included in the challenge results, DistantRace provides an easy and quick way to identify the cause of this problem. Follow the steps described below to find out why your activity is not included in the challenge. **1\. Open your activity list** Open your DistantRace profile view and find the link to your activity list there ([or click here](https://distantrace.com/en/accounts/my_workouts/)). **2\. Find the activity in the list**\ Find the activity that has not been included in the challenge you are participating in. **3\. Open the activity** Click on the activity identifier (ID). Then you will go to the detailed view of the activity where you can see all the activity data. **4\. Open challenges**\ At the top of the page, you will find the "Challenges" section. Click on it and you will see which challenges the activity is associated with. **5\. Check the status of the activity**\ In the challenge section, you can see all the challenges that the activity is associated with and their status. If an activity is not included, the challenge card is colored red and a button "Why not included" appears next to it. **6\. Reasons why the activity is not included** Click on the "Why not included" button and all the reasons why the activity is not included will be displayed. Most likely, the reason for non-inclusion is that the activity does not comply with the challenge rules defined by the organizer. **7\. Contact the challenge organizer** If you think that the activity has not been included in the challenge due to an error, then contact the challenge organizer, explaining why the activity should be included. Each challenge organizer has the option to accept the specific activity in the challenge, and also to make changes to the activity results, if necessary. By following these steps, you can easily understand why an activity is not included, and, by contacting the organizer, you can change the activity status, thus ensuring that all results are calculated correctly and fairly. --- # Withdraw from an event URL: /en/joining-events/withdraw-from-an-event/ # Withdraw from an event You can withdraw from many challenges and some competitions from the registration page. ## Challenges 1. Open the challenge page while logged in. 2. Open the **Register** / apply dialog (or apply page). 3. Use the **Withdraw** or **Quit** action. 4. Confirm — you are removed from the participant list. **Alternative:** Profile → **My clubs** → **Leave club** for a given club lists the active challenges and competitions in that club — withdraw each entry before completing leave. See [Club membership](club-membership.md). If you enrolled in **multiple distances**, withdrawing removes all your entries for that challenge. ## Virtual and in-person competitions Competitions with ticket purchases may not offer self-service withdraw from the event page. Use **My clubs → Leave club** to withdraw individual competition entries when the club lists them, or contact the organizer — refund rules depend on their policy. ## After withdrawing - Your past synced activities may remain in your account but no longer count toward the event. - You can usually register again unless the registration window closed. ## Related - [Participate in a challenge](participate-in-a-challenge.md) --- # Your profile and participant profiles URL: /en/joining-events/your-profile-and-participant-profiles/ # Your profile and participant profiles Your DistantRace **account** holds login details, connected apps, and **saved participant profiles** used when registering for events. **Path:** Log in → Profile / Account settings Account login, email, password, and security: [Managing your account settings](managing-your-account-settings.md). ## Account basics - Profile name and photo — edit on **Profile** - Connected sports apps — [Connections](../connections-with-apps/supported-apps.md) (`/accounts/social/`) ::: tip One account everywhere Use the same login on phone and computer. Multiple accounts are a common cause of missing activities and registrations. ::: ## Saved participant profiles When logged in during checkout, the **Participant menu** lists people you registered before (yourself, family members, club members). Pick a saved profile to auto-fill name, birth date, and contact fields. Create new participant profiles by completing a registration — they are saved for next time. ## Sub-accounts Registering on behalf of someone else adds them as a participant under your payer account. Manage saved profiles (create, edit, unlink, delete) on the **Participants** page — [Managing saved participant profiles](managing-saved-participant-profiles.md). See also [Registering for someone else](registering-for-someone-else.md). ## Orders and events - [My purchases and orders](my-purchases-and-orders.md) — payment history and invoices - Event list — challenges and competitions you joined (from profile navigation) ## Related - [Create an account](create-an-account.md) - [Getting started after signup](getting-started-after-signup.md) --- # Mobile app URL: /en/mobile-app/ # Mobile app The **DistantRace mobile app** (iOS and Android) is the companion app for participants. Use it to sync daily steps, connect sports apps, find and join events, record GPS workouts, and manage your account on the go. ## When you need the app | Use case | App required? | |----------|---------------| | Step challenges | **Yes** — daily steps sync through the app | | Sports activity challenges | Optional — you can connect apps on the website instead | | Recording workouts with your phone | **Yes** — in-app GPS recording | | Scanning event QR codes | **Yes** | | QR login to the website | **Yes** | See also [Mobile app and step challenges](../joining-events/mobile-app-and-step-challenges.md). ## Get started 1. [Installation and sign-in](installation-and-sign-in.md) — download links, social login, first launch 2. [App overview and navigation](app-overview-and-navigation.md) — home screen, tabs, and main features 3. [Step sync setup](step-sync-setup.md) — Apple Health, Health Connect, phone pedometer, and third-party sources 4. [Connecting sports apps](connecting-sports-apps.md) — Garmin, Polar, Fitbit, and other partner apps from the app 5. [Finding and joining events](finding-and-joining-events.md) — QR codes, join codes, and event links 6. [Recording workouts](recording-workouts.md) — GPS activities from the START button 7. [Account and settings](account-and-settings.md) — profile, language, health sync options, sign out 8. [Help and troubleshooting](help-and-troubleshooting.md) — support tickets, sync issues, platform tips ## During a challenge After you join a step or combined challenge on the website or in the app: - [Step game daily tasks](../joining-events/step-game-daily-tasks.md) — sequential daily goals and bonus points - [Challenge message board](../joining-events/challenge-message-board.md) — posts, photos, and comments (also in the app **Posts** tab) - [After joining a challenge](../joining-events/after-joining-a-challenge.md) — results, teams, and navigation tabs ## Account security Set up [Two-factor authentication](../joining-events/two-factor-authentication.md) on the website — required if you also manage events in the organizer console. ## Related guides - [Supported apps](../connections-with-apps/supported-apps.md) - [Joining events](../joining-events/index.md) - [Data synchronization problems](../connections-with-apps/data-synchronization-problems/the-most-common-reasons-for-data-synchronization-issues.md) --- # Account and settings URL: /en/mobile-app/account-and-settings/ # Account and settings Open **Profile** (bottom tab) to manage your account, step source, and partner connections. ## Profile details Edit the participant linked to your login: - Name and birth date - Gender, phone, country - Height and weight (optional — used for calorie estimates) - Profile photo Changes sync to the website — same fields as [Managing your account settings](../joining-events/managing-your-account-settings.md). ## Step source and partner apps - **Step source** — [Step sync setup](step-sync-setup.md) - **Partner apps** — [Connecting sports apps](connecting-sports-apps.md) ## Language Switch app language from Profile → **Language**. Event content may still follow the organizer's published languages. ## Notifications Allow push notifications during onboarding to receive challenge reminders and organizer messages. Fine-grained email categories are managed on the website — [Notification preferences](../joining-events/notification-preferences.md). ## Sign out Profile → **Sign out** revokes the app session. Your synced data stays on the server. ## Delete account Account deletion is completed on the **website** for legal and payment reasons — [Delete your account](../joining-events/delete-your-account.md). The app may link you to the web flow. ## Password and email Add or change password and primary email on the website (`/accounts/email/`, `/accounts/password/change/`) — not all flows are in the mobile app yet. ## Two-factor authentication Enable authenticator app or SMS 2FA on the website — [Two-factor authentication](../joining-events/two-factor-authentication.md). Required for organizer console access; optional for participants only. ## Related - [Create an account](../joining-events/create-an-account.md) - [Sign-in options](../joining-events/sign-in-options.md) --- # App overview and navigation URL: /en/mobile-app/app-overview-and-navigation/ # App overview and navigation After setup, the app opens on a **tabbed home screen** with a central **START** button for recording workouts. ## Bottom navigation | Tab | Purpose | |-----|---------| | **Home** | Today's steps, weekly chart, step goal, active challenges | | **Activity** | Workouts recorded in the app and imported history | | **Posts** | Event message board posts across your joined events | | **Profile** | Account, step source, partner apps, settings, support | The red **START** button in the center is not a tab — it opens the **workout recorder** (walking, running, cycling, and more). See [Recording workouts](recording-workouts.md). ## Home screen The home tab shows: - **Steps ring** — today's step count toward your personal goal - **Weekly bars** — last seven days of steps from DistantRace - **Active challenges** — events you joined; tap for standings and details - **Discover events** — suggested public challenges (when available) Step counts refresh when you open the app, return from the background, or switch back to the Home tab after changing settings. ### QR scanner button A floating **QR code button** sits on the home screen (and on event lists). Use it to: - Join an event by scanning an organizer QR code or event URL - Enter a join code manually - Scan a **website login QR** (`login_…` codes) - Scan **race-day tickets** (13-digit codes starting with `990`) See [Finding and joining events](finding-and-joining-events.md). ### Step details Tap the steps ring or weekly chart to open **step details** — a deeper view of daily totals and sync status. ### Manual step entry Some organizers allow **manual step submission** for specific dates. If enabled for your account, you can add steps from the step details flow when the feature is available. ## Activity tab Lists **workouts recorded in the app** and activities synced to your account. Tap an entry for distance, duration, map, and export options. Workouts from Garmin, Polar, and other connected apps appear here after server sync — not only phone recordings. ## Posts tab Shows **posts from event message boards** across events you participate in. Organizer announcements appear above participant posts. You can compose posts, react, and report content from event-specific feeds. Website equivalent: [Challenge message board](../joining-events/challenge-message-board.md). ## Notifications Push notification permission is requested during onboarding. The in-app **Notifications** screen (filter by category, mark all read) is available in the app; the notification feed may be empty until server push topics are fully wired. Website notification preferences: [Notification preferences](../joining-events/notification-preferences.md). ## Related - [Step sync setup](step-sync-setup.md) - [Finding and joining events](finding-and-joining-events.md) - [Account and settings](account-and-settings.md) --- # Connecting sports apps URL: /en/mobile-app/connecting-sports-apps/ # Connecting sports apps Sports **activity** challenges and virtual competitions need workouts from a connected app. You can connect partners from the **website** or from the DistantRace app. **Path:** Profile → **Partner apps** (or **Connections**) ## Available partners The list matches [Supported apps](../connections-with-apps/supported-apps.md), including: - Garmin Connect - Polar Flow - Fitbit - Suunto - Decathlon Coach - MapMyRun / Under Armour - Withings (Health Mate) - Wahoo Tap **Connect** — the app opens the provider login in an in-app browser (or Safari/Chrome). After you approve access, you return to DistantRace with the connection active. ## Disconnect Open the same partner row and choose **Disconnect**. If that app was also your **step source**, pick a new step source under [Step sync setup](step-sync-setup.md). ## What syncs automatically After connection, new workouts upload to DistantRace within minutes to hours depending on the partner. Historical activities before the connection date usually do not sync — use manual file upload on the website if needed. Strava and Adidas Running are **not** offered for new connections; see [Supported apps](../connections-with-apps/supported-apps.md). ## Step source vs sport sync Some partners supply **both** GPS workouts and daily steps (Garmin, Polar, Fitbit, Suunto, Withings). You can use the same connection for activities while choosing whether that app also feeds step challenges. ## Related - [Managing your activities](../joining-events/managing-your-activities.md) - [Why activities are missing](../joining-events/why-activities-are-missing.md) --- # Finding and joining events URL: /en/mobile-app/finding-and-joining-events/ # Finding and joining events Use the **QR scanner** (floating button on Home and event lists) or open links shared by organizers. ## Scan an event QR code 1. Tap the **QR** button 2. Point the camera at the organizer poster, ticket, or screen 3. The app resolves the event and opens registration or the event home page QR codes may encode a short event slug or full URL — both work when the event is public. ## Enter a join code manually For private events: 1. Open the QR scanner 2. Switch to **Enter code** (or type when prompted) 3. Submit the alphanumeric code from your invitation Invalid or expired codes show an error — ask the organizer for a fresh code. Website guide: [Using a join code](../joining-events/using-a-join-code.md). ## Open shared links Event links from email or social media open in the app when installed (Universal Links on iOS, App Links on Android). Otherwise they open in the mobile browser and you can continue registration there. ## Race-day ticket scan Organizers at the start line may ask you to show a **13-digit ticket code** (often starting with `990`). The scanner validates your registration for check-in — see [Race-day registration as a participant](../joining-events/race-day-registration-as-a-participant.md). ## Discover on Home The **Discover events** section on Home lists suggested public challenges. Tap any card for details and **Join**. Website alternative: browse [distantrace.com](https://distantrace.com) or [Find an event in the app](../joining-events/find-an-event-in-the-app.md). ## Related - [Participate in a challenge](../joining-events/participate-in-a-challenge.md) - [Register for in-person competitions](../joining-events/register-for-in-person-competitions.md) --- # Help and troubleshooting URL: /en/mobile-app/help-and-troubleshooting/ # Help and troubleshooting ## Update the app Install the latest version from the [App Store](https://apps.apple.com/lv/app/distant-race-app/id6447062298) or [Google Play](https://play.google.com/store/apps/details?id=com.distantrace.app). Step sync and Health Connect fixes often require recent builds. ## Steps not syncing 1. Confirm **Step source** under Profile — [Step sync setup](step-sync-setup.md) 2. Open **Home** and pull to refresh (or leave the app in foreground briefly) 3. Check health permissions in phone Settings 4. Read [Data synchronization troubleshooting](../connections-with-apps/data-synchronization-problems/the-most-common-reasons-for-data-synchronization-issues.md) ## Workouts missing - Partner app connected? — [Connecting sports apps](connecting-sports-apps.md) - Activity outside event dates or wrong sport type? — [Why activities are missing](../joining-events/why-activities-are-missing.md) - Upload GPX/FIT manually on the website — [Managing your activities](../joining-events/managing-your-activities.md) ## QR scan fails - Allow **camera** permission - Increase screen brightness when scanning a monitor - For website login QR, generate a fresh code — [Installation and sign-in](installation-and-sign-in.md#qr-login-to-the-website) ## Contact support - In-app: Profile → **Support** / **Help** (opens contact form or mail) - Website: [Contact support from the app](../joining-events/contact-support-from-the-app.md) - Event-specific issues: [Contact the organizer](../joining-events/contact-the-organizer.md) ## Related - [Mobile app and step challenges](../joining-events/mobile-app-and-step-challenges.md) - [Supported apps](../connections-with-apps/supported-apps.md) --- # Installation and sign-in URL: /en/mobile-app/installation-and-sign-in/ # Installation and sign-in The DistantRace app is available for **iOS** and **Android**. You need a DistantRace account — create one on the website or during first launch in the app. ## Download the app | Platform | Link | |----------|------| | iOS (App Store) | [DistantRace on the App Store](https://apps.apple.com/lv/app/distant-race-app/id6447062298) | | Android (Google Play) | [DistantRace on Google Play](https://play.google.com/store/apps/details?id=com.distantrace.app) | You can also open [distantrace.com/app](https://distantrace.com/app) on your phone — event landing pages often link there too. ## Sign-in options On the welcome screen, sign in with the same account you use on [distantrace.com](https://distantrace.com): - **Apple** (iOS) - **Google** - **Facebook** Use the same provider you linked on the website. If you registered with email and password only, sign in on the website first and link a social provider under [Connections](../connections-with-apps/supported-apps.md), or use [QR login](#qr-login-to-the-website) from an already-signed-in phone. For all website sign-in methods (email code, passkey, enterprise SSO), see [Sign-in options](../joining-events/sign-in-options.md). ## First launch After sign-in, new users see: 1. **Onboarding carousel** — four screens introducing workout recording, challenges, leagues, and step games. Swipe through or skip to continue. 2. **Permissions setup** — step source, health permissions, optional height for calorie estimates, location (for GPS workouts), and push notifications. If you connect a watch-based step source (Garmin, Fitbit, etc.) instead of a phone source, the app may only ask for notifications before opening the main screen. ## QR login to the website You can authorize a **browser session** by scanning a QR code shown on distantrace.com: 1. On the website, choose **Login with QR** (or similar). 2. In the DistantRace app, open the **QR scanner** (floating button on the home screen). 3. Point the camera at the website QR code. Codes starting with `login_` are handled as sign-in requests. 4. Confirm **Successfully authorized** on the result screen. The browser session is logged in. If authorization fails, try again with a fresh QR code. See [Sign-in options](../joining-events/sign-in-options.md#mobile-app-qr-login). ## Email verification If your email is not verified, the app shows a reminder after you reach the main tabs. Verify via the link sent to your inbox so account recovery and notifications work reliably. ## Related - [App overview and navigation](app-overview-and-navigation.md) - [Step sync setup](step-sync-setup.md) - [Create an account](../joining-events/create-an-account.md) --- # Recording workouts URL: /en/mobile-app/recording-workouts/ # Recording workouts Record outdoor workouts **directly in the app** when you do not use Garmin, Polar, or another sync partner. ## Start a workout 1. Tap the red **START** button on the bottom navigation bar 2. Choose a **sport** (running, walking, cycling, etc.) — only sports with GPS are shown for recording 3. Wait for GPS lock, then tap **Start** 4. Pause or stop when finished — save the workout The app uploads the track to your DistantRace account as a **mobile app** activity. It appears under **Activity** and on the website at [My workouts](../joining-events/managing-your-activities.md). ## Permissions **Location (While Using)** is required for route recording. **Motion & Fitness** improves distance accuracy on iOS. ## After saving - Open the workout in **Activity** to view map, distance, duration, and pace - Valid activities auto-match open challenges and virtual competitions you joined - If an activity does not count, read the exclusion reason — [Why activities are missing](../joining-events/why-activities-are-missing.md) ## When to use another app instead Prefer Garmin, Polar, or Apple Watch sync when you already record there — duplicate phone recordings can double-count if both upload the same session. Indoor sessions without GPS should be recorded in a partner app that supports indoor sport types, or uploaded manually on the website. ## Related - [Supported apps](../connections-with-apps/supported-apps.md) - [Participate in virtual competitions](../joining-events/participate-in-virtual-competitions.md) --- # Step sync setup URL: /en/mobile-app/step-sync-setup/ # Step sync setup Step challenges require a **daily step source**. The app walks you through this during first launch; you can change it later under **Profile → Step source**. ## Phone-based sources | Source | Platform | Notes | |--------|----------|-------| | **Apple Health** | iOS | Reads step data HealthKit already collects | | **Health Connect** | Android | Google's health hub (recommended on newer Android) | | **Google Fit** | Android | Legacy option where Health Connect is unavailable | | **Phone pedometer** | Android | On-device step counter — keep the app installed and background refresh enabled | Grant **health / activity** permissions when prompted. Without them, step totals stay at zero. ## Watch and partner apps You can also count steps from connected sport apps: - Garmin - Polar - Fitbit - Suunto - Withings (Health Mate) Connect the app first under **Profile → Partner apps**, then select it as your step source. Polar and Suunto may trigger a server pull when you open the step screen. ## Changing source later 1. **Profile** → **Step source** 2. Pick a new provider 3. If you chose a sport app that is not connected yet, the app opens the OAuth connect flow and returns you to step setup On the website you can also change source at `/accounts/step_data_source/` — [Daily steps on the website](../joining-events/daily-steps-on-the-website.md). ::: warning One primary source Use only **one** active step source to avoid double counting the same walks. ::: ## Coverage sync (Apple Health / Health Connect) The app checks which days still need uploads and sends missing daily totals to DistantRace automatically when you open **Home** or after background refresh. Older app versions may estimate calories from steps; newer versions send calories and distance from the health store when available. ## Troubleshooting | Problem | Try | |---------|-----| | Steps stuck at zero | Re-open permissions in phone Settings → DistantRace → Health | | Garmin/Fitbit missing days | Open the sport app to force a sync, then reopen DistantRace | | Wrong totals after switching source | Wait one full day — do not run two sources at once | More: [Data synchronization troubleshooting](../connections-with-apps/data-synchronization-problems/the-most-common-reasons-for-data-synchronization-issues.md). ## Related - [How to set up a step data source in the DistantRace app](../connections-with-apps/how-to-set-up-a-step-data-source-in-the-distantrace-app.md) - [Mobile app and step challenges](../joining-events/mobile-app-and-step-challenges.md) --- # More tools URL: /en/more-tools/ # More tools Utilities that support day-to-day event operations beyond core event settings. | Tool | Guide | |------|-------| | Data export | [How to export data from DistantRace](how-to-export-data-from-distantrace.md) | | Document library | [Organizer documents](organizer-documents.md) | | CSV import | [CSV importer](csv-importer.md) — not the same as timing file import | | Duplicate cleanup | [Merging duplicate participants](merging-duplicate-participants.md) | | REST API map | [Public API overview](public-api-overview.md) | ## Related - [Finance module](../finance-module/introduction-to-the-finance-module.md) - [Results](../results/index.md) --- # CSV importer URL: /en/more-tools/csv-importer/ # CSV importer Import participants and finish times from a **CSV file** when migrating from another system or receiving custom timing exports. **Path:** Open competition → **Importer** ## Before you import - Back up existing data — the importer can **delete all participants** (only when no carts exist) - Prepare CSV with required columns matching DistantRace field names - Resolve duplicate emails and bib numbers beforehand ## Import steps 1. Competition → Importer 2. Upload CSV file 3. Wait for the background job — progress shows on the same page 4. Review participants on the start list and results on the results page ## Participants and results The importer can load both registration data and finish times in one file, depending on column mapping. ## Three import tools — do not mix them up | Tool | Path | Use for | |------|------|---------| | **CSV importer** | Competition → **Importer** | Bulk participant + result migration from another system (one CSV upload) | | **Timing file import** | Competition → Results → **Import file** | Race-day timing provider exports (Race Result, MyLaps, etc.) | | **Results URL sync** | Competition → Results → **URL sync** | Automatic pull from a timing provider URL on a schedule | The CSV importer can **delete all participants** when no carts exist — back up first. Timing imports never replace the whole start list. ## Alternatives - [Importing timing results](../running-events/importing-timing-results.md) — timing provider file formats (Race Result, MyLaps, etc.) - [Results URL sync](../running-events/results-url-sync.md) — automatic pull from timing URL Do **not** use the CSV importer for live timing feeds — use file or URL import instead. ## Related - [Merging duplicate participants](merging-duplicate-participants.md) --- # How to export data from DistantRace? URL: /en/more-tools/how-to-export-data-from-distantrace/ # How to export data from DistantRace? Organizers export data in **XLSX** or **PDF** from list views and dashboard actions. Large exports run in the background — download finished files from [Organizer documents](organizer-documents.md) (club → **More tools** → **Documents**). ## Common export locations | Data | Path | Guide | |------|------|-------| | Challenge participants + custom questions | Challenge → Participants → **Export XLSX** | [Exporting challenge data](../running-events/exporting-challenge-data.md) | | Challenge daily steps | Challenge → Workouts → **Export XLSX** | [Exporting step challenge daily results](../running-events/exporting-step-challenge-daily-results.md) | | Challenge teams | Challenge → Teams → **Export XLSX** | [Exporting challenge data](../running-events/exporting-challenge-data.md) | | Competition start list + answers | Competition → Start list → export menu | [Managing the start list](../running-events/managing-the-start-list.md) | | Marketing contacts | Start list → **Marketing export** or Marketing → **Export** | [Marketing email export filters](../running-events/marketing-email-export-filters.md) | | Race results | Competition → Results → **Export XLSX** | [Exporting results data](../results/exporting-results-data.md) | | Sold tickets | Competition → Tickets → **Sold** → export | [Managing tickets and pricing](../running-events/managing-tickets-and-pricing.md) | | Invoices | Finance → Invoices → export | [Invoicing](../finance-module/invoicing.md) | | Fee breakdown | Finance → **Fee details** → export | [Financial data summary](../finance-module/financial-data-summary.md) | | Discount codes | Finance → Discount codes → campaign → **Export XLSX** | [Discount codes](../finance-module/discount-codes.md) | | Shop products sold | Shop → Products → **Bought** → export | [Shop bought products list](../running-events/shop-bought-products-list.md) | | Join codes | Challenge/Competition → Settings → Join codes → export | [Join codes and invitations](../running-events/join-codes-and-invitations.md) | | Yearly income | Club → Competitions → yearly export | [Yearly income export](../finance-module/yearly-income-export.md) | ## CSV import vs exports The [CSV importer](csv-importer.md) **imports** participants into a competition — it is not an export tool. For timing feeds use [file import](../running-events/importing-timing-results.md) or [URL sync](../running-events/results-url-sync.md). ## Custom exports Need a report not listed here? Email support@distantrace.com — we can add export columns or one-off reports. ## Related - [Organizer documents](organizer-documents.md) - [Access the organizer console](../running-events/access-the-organizer-console.md) ![Screenshot 2024-06-25 at 17.26.52.png](/static/img/more-tools/how-to-export-data-from-distantrace/screenshot-2024-06-25-at-17-26-52.png) ![Screenshot 2024-06-25 at 17.30.52.png](/static/img/more-tools/how-to-export-data-from-distantrace/screenshot-2024-06-25-at-17-30-52.png) --- # Merging duplicate participants URL: /en/more-tools/merging-duplicate-participants/ # Merging duplicate participants Duplicate registrations (same person entered twice with slightly different details) can be merged from the competition start list. **Path:** Open competition → **Start list** → **Merge** ## When to merge Common causes: - Participant registered twice with different emails - Import overlapped with online registration - Manual entry duplicated an existing racer ## Merge workflow 1. Start list → **Merge** — DistantRace suggests likely duplicates 2. Review pairs side by side (name, email, bib, payment) 3. Confirm merge — data from both entries combines into one participant record 4. Re-check bib numbers and results after merging ## Automatic merge **Start list → Merge → Auto merge** queues a background job that finds likely duplicate pairs and merges them without stepping through each suggestion manually. | Option | Behavior | |--------|----------| | **Auto merge (suggested pairs only)** | Merges high-confidence duplicates from the suggestion list | | **Auto merge all** | Runs a broader scan across the full start list (use after large imports) | Review bib numbers and results after a batch auto-merge — the job runs asynchronously and may take a few minutes on large events. Bib number pre-assignment can optionally run merge before assigning numbers (competition setting). ## Related - [Managing the start list](../running-events/managing-the-start-list.md) - [CSV importer](csv-importer.md) --- # Organizer documents URL: /en/more-tools/organizer-documents/ # Organizer documents Large exports and generated reports are stored in the club **Documents** library instead of downloading immediately. **Path:** Manager console → **More tools** → **Documents** ## What appears here - Excel exports (participants, results, standings, invoices, sold tickets) - Bulk PDF generation jobs - Custom export requests processed by support ## Download Open Documents, find the file by date and type, and download. Files expire after a retention period — export again if needed. ## Triggering exports Most list views have an **Export** action (three-dot menu or dedicated button). The job queues in the background; refresh Documents when complete. See [How to export data](how-to-export-data-from-distantrace.md). ## Related - [Purchase summary](../finance-module/purchase-summary.md) - [Invoice summary](../finance-module/invoice-summary.md) --- # Public API overview URL: /en/more-tools/public-api-overview/ # Public API overview DistantRace exposes a **REST API** (`/api/v1/`) used by the mobile app, partner integrations, and whitelabel platforms. This is a high-level map — not a full OpenAPI reference. ::: warning Integration support API access for third-party development is typically arranged with DistantRace support. Authentication and rate limits apply. ::: ## Base URL ``` https://distantrace.com/api/v1/ ``` ## Authentication | Grant / token | Typical caller | Scope | |---------------|----------------|-------| | **Session / mobile token** | DistantRace app, logged-in web | User-scoped read/write | | **Org token** (`client_credentials`) | Whitelabel portal backend | Public listings, join-code validate/redeem, hero images | | **User OAuth** (authorization code + refresh) | Whitelabel SPA after sign-in | Join, workouts, profile, checkout | Whitelabel integrations use two credential types: | Credential | Use | |------------|-----| | **Org token** (long-lived bearer) | Public event/challenge listings, hero images, join-code validation, email-token redemption | | **User OAuth client** (authorization code) | Participant sign-in, join events, workouts, profile, checkout | The org token is resolved from the OAuth application owner — every whitelabel API call is implicitly scoped to one club. Account endpoints include login QR, social login, profile (`/api/v1/account/me/`), and device registration. See [Whitelabel and enterprise setup](../running-events/whitelabel-and-enterprise-setup.md) for the full participant-portal model. ### Whitelabel join-code flows | Endpoint | Method | Purpose | |----------|--------|---------| | `event/joincode/{code}/validate/` | GET | Check whether a code is active for your org; returns public event payload (no participant PII) | | `event/joincode/redeem-email-token/` | POST | Consume a magic-link token from an invitation email; returns OAuth tokens and may auto-enrol in a challenge | | `event/joincode/` | POST | Create a join code and send invitation email (admin user token only — not the public org token) | Magic-link redemption uses the org token plus a single-use `token` in the POST body. The server may create a user from join-code prefill data, issue access/refresh tokens, and call auto-enrol when the code is bound to a challenge. ### Hero images (whitelabel only) `GET orgs/hero-images/?language=` — active carousel images for the token's organization. Requires `is_whitelabel` on the club. Optional language filter returns locale-specific images plus language-neutral fallbacks. ## Main resource groups | Prefix | Resources | |--------|-----------| | `event/` | Events, join codes, posts | | `gamification/` | Challenges, challengers, team challenges, goals, daily stats | | `races/` | Competitions, entrants (racers), results | | `shop/` | Carts, cart items, products, premium levels | | `users/` | Users, participants, push devices | | `workouts/` | Activities, upload, sport/kind metadata | | `orgs/` | Organizations, hero images (whitelabel) | | `finances/` | Payment channels, pricing helpers | ## Common integration tasks | Task | Typical endpoints | |------|-------------------| | List published events | `event/event/` | | Register participant | `races/registration/entrant/` | | Sync activities | `workouts/` or `workouts/upload/` | | Read results | `races/result/` | | Mobile daily steps | `gamification/dailystat/` | ## Enterprise SSO SAML endpoints (platform auth host): | Path | Purpose | |------|---------| | `/saml2/discovery/` | Enter work email → route to the correct IdP by domain | | `/saml2/login/` | Start SAML authentication (optional `idp` and `next` query params) | | `/saml2/acs/` | Assertion consumer (IdP callback) | | `/saml2/metadata/` | Service-provider metadata for IdP configuration | When multiple identity providers exist, discovery matches the email **domain** to an IdP before redirecting to login. With a single IdP, discovery skips straight to `/saml2/login/`. Participant and staff flows: [Enterprise SAML and whitelabel login](../joining-events/enterprise-saml-and-whitelabel-login.md). ## Data export alternative For one-off spreadsheets without coding, use manager **exports** — [Organizer documents](organizer-documents.md), [Exporting results data](../results/exporting-results-data.md), [Yearly income export](../finance-module/yearly-income-export.md). ## Related - [Whitelabel and enterprise setup](../running-events/whitelabel-and-enterprise-setup.md) - [How to export data from DistantRace](how-to-export-data-from-distantrace.md) - [Integrations](../integrations/introduction-to-integrations.md) --- # Nature protection URL: /en/other-information/nature-protection/ # Nature protection DistantRace only uses data centers powered by green energy. Our partner is [Hetzner](https://www.hetzner.com/unternehmen/umweltschutz/), which uses only wind and hydro energy. ![](/static/img/other-information/nature-protection/image-1712291645582.png) --- # Real race management URL: /en/real-race-management/ # Real race management Guides for **in-person** (real) races have moved to two sections. Legacy `/en/real-race-management/` URLs redirect automatically. ## Participants → Joining events | Topic | Guide | |-------|-------| | Online registration | [Register for in-person competitions](../joining-events/register-for-in-person-competitions.md) | | Race-day self-registration | [Race-day registration as a participant](../joining-events/race-day-registration-as-a-participant.md) | | In-store desk signup | [In-store registration](../joining-events/in-store-registration.md) | | Group / partner cart link | [Joining via dynamic cart link](../joining-events/joining-via-dynamic-cart-link.md) | | Checkout add-ons | [Checkout add-ons and shipping](../joining-events/checkout-add-ons-and-shipping.md) | ## Organizers → Running events | Topic | Guide | |-------|-------| | Create an in-person race | [Create an in-person race](../running-events/create-an-in-person-race.md) | | Race-day registration desk | [Race-day registration and check-in](../running-events/race-day-registration-and-check-in.md) | | On-site payment | [On-site payment and in-store registration](../running-events/on-site-payment-and-in-store-registration.md) | | Bib numbers | [Bib number management](../running-events/bib-number-management.md) | | Start list | [Managing the start list](../running-events/managing-the-start-list.md) | | Import timing results | [Importing timing results](../running-events/importing-timing-results.md) | | Partner / corporate registration | [Partner and corporate registration](../running-events/partner-and-corporate-registration.md) | | Upsell products | [Upsell products in checkout](../running-events/upsell-products-in-checkout.md) | ## Related - [Running events](../running-events/index.md) — full organizer guide - [Joining events](../joining-events/index.md) — full participant guide --- # How to record a sports activity using the Adidas Running app URL: /en/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-adidas-running-app/ # How to record a sports activity using the Adidas Running app ::: warning No longer available Adidas Running (Runtastic) is no longer supported in DistantRace. See [Supported apps](../connections-with-apps/supported-apps.md) for current options. ::: Recording workouts with the Adidas Running app is a user-friendly process, available for both Android and iOS users. How to record a sports activity: 1. Tap on "Activity", located at the bottom of the app screen. 2. If you wish to change the sport type of your workout, tap on the settings icon. 3. In settings, find and tap on "Activity Type". 4. Choose your desired sport type from the available options. 5. Wait for the phone to find the GPS signal to accurately track the workout. 6. Once the GPS signal is established, tap "Start" to begin recording the workout. 7. The app will give you 15 seconds to prepare for the workout. 8. Carry your phone with you throughout the workout. 9. Upon completing the workout, touch the "Lock" icon, located between the "Pause" and "Finish" buttons. This will unlock the buttons. 10. Tap "Finish." 11. On the next page, press "Save" If your Adidas Running app account is connected to DistantRace, the recorded workout will be saved and automatically synchronized with DistantRace. ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-adidas-running-app/image-1712064759120.jpg) ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-adidas-running-app/image-1712064830131.jpg) ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-adidas-running-app/image-1712064891453.jpg) --- # How to record a sports activity using the Decathlon Coach app URL: /en/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-decathlon-coach-app/ # How to record a sports activity using the Decathlon Coach app The Decathlon Coach app offers a user-friendly interface for recording workouts, whether you're using an iOS or Android device. The steps for recording a workout are similar across both platforms, ensuring a seamless experience. How to record a sports activity: 1. Press "Home", which is located at the bottom of the app screen. 2. Tap the "Free session" button to start recording your workout. 3. Choose a sport type from the list provided. 4. Allow the app to access your phone's GPS data. This is very important for accurately tracking your route and distance during the workout. 5. Wait until your phone finds the GPS signal. 6. Once the GPS signal is found, workout recording begins. Carry your phone with you throughout the workout. 7. When you have finished your workout, press the orange "Pause" button to temporarily stop recording. 8. To finish and save your workout, press the red "Stop" button. If you have linked your Decathlon Coach account with DistantRace, the recorded workout will automatically sync with DistantRace. ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-decathlon-coach-app/image-1712063462428.jpg) ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-decathlon-coach-app/image-1712063526025.jpg) --- # How to record a sports activity using the Fitbit app URL: /en/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-fitbit-app/ # How to record a sports activity using the Fitbit app Recording sports activities with the Fitbit app is a simple process, whether you're using the iOS or Android version. The interface remains consistent across both platforms. Follow these steps to record a sports activity using the Fitbit app: 1. Open the Fitbit app on your smartphone. 2. At the bottom of the app, look for the "Today" icon and tap it. 3. Press "Track Your Exercise." 4. Next, in the top right corner of the app, press the timer icon to access the tracking tab. 5. Wait for the app to establish a GPS signal. This signal is very important for accurately tracking your workout route. 6. Choose the type of workout you want to start. Currently, Fitbit allows you to choose from options such as Running, Hiking, and Walking. Note that available sports types may be limited. If your desired sport type is not available - you can still choose any available sport type for recording the activity, for example, a run, and then change it in DistantRace to another sport type. 7. To start recording the workout, press the red "Play" button. Carry your phone with you throughout the workout. 8. When you have finished your workout, press "Pause" to temporarily stop the recording. 9. Finally, press "Finish" to complete the workout recording. Once the workout is saved in the Fitbit app, it will automatically sync with DistantRace if you have linked your Fitbit account with DistantRace. This ensures that your workout data is seamlessly processed and added to your challenges and competitions. ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-fitbit-app/image-1712062105184.png) ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-fitbit-app/image-1712062160768.png) --- # How to record a sports activity using the Health Mate (Withings) app URL: /en/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-health-mate-withings-app/ # How to record a sports activity using the Health Mate (Withings) app Recording workouts with the Health Mate app, developed by Withings, is a straightforward process for both Android and iOS users. ❗However, an important note must be taken into account: Withings does not grant DistantRace permission to access users' GPS data (workout route). As a result, users cannot participate in challenges where GPS data is mandatory. How to record a sports activity: 1. Press "Home", located at the bottom of the app interface. 2. Tap the "+" icon, located in the upper right corner of the screen. 3. From the options presented, choose "Activity". 4. Select a sport type from the list provided. 5. After selecting the sport type, press "Record a new workout". 6. At this point, the recording of the workout begins. Carry your phone with you for the duration of the workout. 7. When you have completed the workout, hold down the "Stop" button. If you have connected your Withings account to DistantRace, the recorded workout will be saved and automatically synchronized with DistantRace. It is important to note that, although Health Mate can record workout data, app limitations prevent DistantRace from accessing GPS data. Therefore, it is not possible to participate in challenges requiring GPS data with Health Mate. ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-health-mate-withings-app/image-1712064365370.jpg) ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-health-mate-withings-app/image-1712064421801.jpg) --- # How to record a sports activity using the Map My Walk/Run/Ride app URL: /en/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-map-my-walkrunride-app/ # How to record a sports activity using the Map My Walk/Run/Ride app The Map My Walk, Map My Run, and Map My Ride apps, which are part of the Under Armour family, offer a versatile platform for recording workouts. You can use any of these apps with the same Under Armour account. These apps have similar features and support various sports, allowing you to seamlessly switch between different activities. Whether you're using the iOS or Android version, the user experience is excellent. How to record an activity: 1. At the bottom of the app screen, find the timer icon and tap it. 2. Select your desired sport type from the list. It's worth noting that any of these apps can record any type of workout. For example, you can use the Map My Walk app to record a bike ride. 3. Wait until the device captures the GPS signal. This signal is very important for accurately tracking your workout route and distance. 4. Once the GPS signal is established, press the "Start Workout" button to begin recording your workout. 5. Carry your phone with you during the workout. 6. When you have finished your workout, press the "Pause" button to temporarily stop the recording. 7. To finish and save your workout, hold down the "Hold to Finish" button. 8. Don't forget to press "Save Workout" to save the recorded workout in the app so that DistantRace can receive it. If you have linked your Map My Walk/Run/Ride account with DistantRace, your recorded workout will automatically sync with DistantRace for further processing and will be added to your challenges and competitions. ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-map-my-walkrunride-app/image-1712062945324.jpg) ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-map-my-walkrunride-app/image-1712063086404.jpg) --- # How to record a sports activity using the Polar Flow app URL: /en/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-polar-flow-app/ # How to record a sports activity using the Polar Flow app If you use the Polar Flow app for training, the steps below show how to record a workout. Please note that the navigation process may differ slightly between Android and iOS versions of the app. **For Android users:** In the top left corner of the app, find the navigation icon and press it. Then press "Start". ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-polar-flow-app/image-1712058693989.png) **For iPhone users:** Find the "Start" icon, which is located at the bottom of the app interface. ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-polar-flow-app/image-1712058716863.png) Regardless of the operating system, once you have started recording your workout, the next steps are the same for both. The example images are from the Polar Flow app on an Android phone: 1. In the app, find the settings icon and touch it. 2. Find the option to choose a sport and press it. 3. Choose your desired sport from the list of allowed sports. 4. Make sure the option to use the phone's GPS data is turned on. 5. If you have selected the desired sport and the GPS is turned on, you can start recording your workout. Simply click the "Start" button to begin recording your workout. Keep the phone with you at all times during the workout. 6. When you are ready to finish the workout, click the "Pause" button to temporarily stop recording the workout. 7. To finish the workout, hold down the "Stop" button. At this point, your workout record is saved in the Polar Flow app. If you have previously connected your Polar Flow account with DistantRace, the workout data will be automatically sent to DistantRace for processing and inclusion in your challenges and competitions. ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-polar-flow-app/image-1712059167816.png) ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-polar-flow-app/image-1712059106257.jpg) --- # How to record a sports activity using the Strava app URL: /en/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-strava-app/ # How to record a sports activity using the Strava app ::: note Direct Strava sync unavailable DistantRace cannot receive activities directly from Strava. After recording, use a workaround from [Strava and DistantRace connection](../connections-with-apps/strava-and-distantrace-connection.md) (manual upload, Suunto, or Wahoo). This page covers recording workouts in the Strava app only. ::: Recording workouts with the Strava app is a user-friendly process available to both Android and iOS users. How to record a sports activity: 1. Open the Strava app and press the "Record" button at the bottom center of the screen. 2. If you want to change the sport type of your workout, press the sport selection icon (second from the left) and choose the appropriate sport. 3. To start recording the activity, press the "Start" button. Go for your workout and take your phone with you. 4. When the workout is finished, press the "Stop" button and then the "Finish" button. 5. Save the activity. 6. Once the activity is saved, export or sync it to DistantRace using one of the options in [Strava and DistantRace connection](../connections-with-apps/strava-and-distantrace-connection.md) — direct Strava-to-DistantRace sync is not available. ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-strava-app/image-1717157209606-05-02.png) ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-strava-app/image-1717157215465-05-23.png) --- # How to record a sports activity using the Suunto app URL: /en/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-suunto-app/ # How to record a sports activity using the Suunto app Recording a workout with the Suunto app is a straightforward process, whether you're using the iOS or Android version. While there may be slight differences in the interface, the overall steps remain the same. For illustration purposes, the following steps are shown using the Android Suunto app. Below, we have compiled information to successfully record your workout using the Suunto app and sync it with DistantRace. **Record your sports activity:** 1. The first time you log in to the Suunto app, you might be prompted to add a watch. If you plan to use the app only, you can skip this step. 2. Find the "+" icon, which is located in the upper right corner of the app interface, and tap it. 3. Choose "Record with app" from the menu that appears. 4. If you wish to change the "Activity type," tap the field and select from the list provided. 5. Press "Continue" to proceed. 6. The app will start searching for a GPS signal. Wait until the signal is found, as it is essential for recording your workout route. 7. Once the GPS signal is found, press "Start" to begin recording your workout. Remember to carry your phone with you during the workout. 8. After completing your workout, press "Stop" to temporarily pause the recording. 9. Press "End" to finish recording the workout. 10. Save your workout to complete the process. If you have previously connected your Suunto app to your DistantRace account, your recorded workout data will be automatically sent to DistantRace for processing and included in your challenges and competitions. ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-suunto-app/image-1712059626693.png) ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-suunto-app/image-1712059700873.png) ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-suunto-app/image-1712059765091.png) --- # How to record a sports activity using the Wahoo Fitness app URL: /en/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-wahoo-fitness-app/ # How to record a sports activity using the Wahoo Fitness app The Wahoo Fitness app provides the capability to record workouts even if you do not have Wahoo equipment. It's important to note that there is also a Wahoo ELEMNT app, but it is exclusive to Wahoo devices. How to record a sports activity: 1. Press the "Workout" icon, which is usually located in the lower left corner of the app. 2. If you want to change the type of workout, select the desired workout type from the options provided. Please note that Wahoo offers a limited number of sport types, but after uploading the activity to DistantRace, it's possible to change the sport type in DistantRace if needed. 3. Wait until the phone finds the GPS signal, which is crucial for accurately tracking the workout. 4. Once the GPS signal is found, press the "Enter Workout" button on the screen. 5. On the next screen, press "Start" to begin recording the workout. 6. Ensure you carry your phone with you throughout the workout. 7. When you have finished the workout, press "Pause" and then "Stop". 8. To save the workout, press "Save Workout". If your Wahoo Fitness app account is connected to DistantRace, the recorded workout will automatically be synchronized with DistantRace. ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-wahoo-fitness-app/image-1712065320405.jpg) ![](/static/img/recording-activities-with-a-smartphone/how-to-record-a-sports-activity-using-the-wahoo-fitness-app/image-1712065396214.jpg) --- # Results URL: /en/results/ # Results Manage finish times, standings, and certificates for competitions and challenges. ## Competitions (races) | Task | Guide | |------|-------| | Import timing data | [Importing timing results](../running-events/importing-timing-results.md) | | URL sync from timing provider | [Results URL sync](../running-events/results-url-sync.md) | | Map external distance IDs | [Competition distance sync mapping](../running-events/competition-distance-sync-mapping.md) | | Edit individual results | [Managing race results](managing-race-results.md) | | Bulk recalculate & exports | [Results bulk actions](results-bulk-actions.md) · [Exporting results data](exporting-results-data.md) | | Publish to public | [Publishing results](publishing-results.md) | | Overall & age-group standings | [Standings and rankings](standings-and-rankings.md) | | Finisher diplomas (PPTX upload) | [Diplomas and finisher documents](diplomas-and-finisher-documents.md) | | PPTX design reference | [Race certificate creation](race-certificate-creation.md) | | Public results display | [Customizing results tables](../running-events/customizing-results-tables.md) | | Embed on your website | [Embedding results](../running-events/embedding-results-on-your-website.md) | ## Challenges Challenge results are computed from synced activities (steps, distance, points). Organizers review activities and standings in the challenge manager — see [Managing challenge participants](../running-events/managing-challenge-participants.md). ## Related - [Reviewing virtual workouts](../running-events/reviewing-virtual-workouts.md) - [Checkpoint passages](../running-events/checkpoint-passages.md) --- # Diplomas and finisher documents URL: /en/results/diplomas-and-finisher-documents/ # Diplomas and finisher documents DistantRace generates finisher **diploma images** from **PowerPoint (PPTX) templates** you design externally. Placeholder text in the file is replaced with participant data when diplomas are generated. ::: note Built-in design editor removed The manager no longer includes an in-browser diploma editor (background upload and drag-and-drop fields). Design your layout in PowerPoint or Canva, then upload the `.pptx` file. ::: ## Where to manage diplomas | Event type | Manager path | |------------|--------------| | Competition (race) | Open competition → **Diploma** (one template per distance with results) | | Challenge (steps, distance, etc.) | Open challenge → **Diploma** | Step challenge organizers can also follow [Create diplomas for all participants](../daily-step-challenges/how-to-create-diplomas-for-all-participants.md). ## Workflow 1. **Design** a `.pptx` file with merge-field placeholders (see [Race certificate creation](race-certificate-creation.md) for the full field list, Canva tips, and sample templates). 2. **Upload** the file on the Diploma page and click **Save** — a preview image is generated automatically. 3. **Publish** by checking **Is published?** so new finishers receive diplomas when results are added. 4. **Generate** for existing participants with **Save & Generate**. ## Automatic fields by event type | Field group | Races | Challenges | |-------------|-------|------------| | Name, event, group, team | Yes | Yes | | Finish time, placing, laps | Yes | — | | Steps, distance, points, energy, rank | — | Yes | See the complete field reference in [Race certificate creation](race-certificate-creation.md). ## Participant access When results are published and diplomas are generated, participants download them from their result or challenge profile page. ## Related - [Race certificate creation](race-certificate-creation.md) — PPTX design guide with all merge fields - [Create diplomas for step challenges](../daily-step-challenges/how-to-create-diplomas-for-all-participants.md) - [Managing race results](managing-race-results.md) - [Standings and rankings](standings-and-rankings.md) - [Downloading diplomas and certificates](../joining-events/downloading-diplomas-and-certificates.md) --- # Exporting results data URL: /en/results/exporting-results-data/ # Exporting results data Beyond editing individual finishers, the competition **Results** list can export data for timing partners, federations, archives, and press. **Path:** Competition → **Results** → export actions See also [Results bulk actions](results-bulk-actions.md) for recalculate and email options. ## Spreadsheet export (XLSX) **Export XLSX** generates a full results workbook — finisher names, times, status, distance, and columns visible in the manager table. The file is prepared asynchronously and appears under [Organizer documents](../more-tools/organizer-documents.md) when ready. ## JSON-LD export (OADM) **Export JSON-LD** produces structured open-data style output for federation feeds or external result systems. Use when a partner requests machine-readable results instead of Excel. ## PDF reports From the results actions menu, generate printable PDFs: | Report | Content | |--------|---------| | Overall results | Full list or top 20 | | By gender | Men / women tables | | By distance | Per-distance finish lists | | Progressive / most active | Specialty rankings when configured | | Team results | Team scores (top 20 optional) | | Standings | Series points, groups, gender splits | When the competition has **series standings** configured, additional standings PDF variants appear. ## Custom club PDFs Some clubs have **custom PDF layouts** stored in their organizer export folder. These appear as extra export buttons on the results page. ## Start list exports Participant exports (full start list, per distance, marketing contacts) live on **Start list**, not Results — [Managing the start list](../running-events/managing-the-start-list.md). ## Related - [Managing race results](managing-race-results.md) - [Publishing results](publishing-results.md) - [Standings and rankings](standings-and-rankings.md) - [Importing timing results](../running-events/importing-timing-results.md) --- # Managing race results URL: /en/results/managing-race-results/ # Managing race results After importing timing data or entering results manually, review and correct individual finisher records before publishing. **Path:** Open competition → **Results** ## Result list Filter by distance, status (finished, DNF, DNS), or search by name/bib. Export to Excel from the table menu. ## Edit a result Open a result to change: - Finish time (chip time, gun time) - Status — finished, DNF, DNS, DSQ - Participant link (if mismatched from import) - Lap/split data (multi-lap courses) ## Add a result manually Use **Add result** for late finishers or corrections not in the timing file. Link to the correct participant and distance. ## Publish Results can remain draft until you are ready. Publishing makes them visible on public standings and triggers result emails if [email templates](../integrations/email-templates-and-export.md) are configured. Bulk recalculate, PDF exports, and result emails: [Results bulk actions](results-bulk-actions.md). ## Related - [Importing timing results](../running-events/importing-timing-results.md) - [Results bulk actions](results-bulk-actions.md) - [Standings and rankings](standings-and-rankings.md) - [Race certificate creation](race-certificate-creation.md) --- # Publishing results URL: /en/results/publishing-results/ # Publishing results Results can exist in draft after import before you publish them to the public results page. ## Before publishing 1. [Import](../running-events/importing-timing-results.md) or [enter](managing-race-results.md) all finish times 2. Review [standings](standings-and-rankings.md) for obvious errors 3. Configure [results table columns](../running-events/customizing-results-tables.md) ## Publish From the competition results or standings view, enable publication (exact control depends on event settings — results may auto-publish on import or require manual publish). When published: - Public results and standings pages update - Embedded iframes show new data - Result emails send if [email templates](../integrations/email-templates-and-export.md) are configured - Published [diplomas](diplomas-and-finisher-documents.md) become downloadable for finishers with a PPTX template uploaded ## Unpublish or correct Edit individual results after publishing — standings recalculate. For major corrections, import a corrected file and re-review before notifying participants. ## Related - [Managing race results](managing-race-results.md) - [Embedding results](../running-events/embedding-results-on-your-website.md) --- # Race certificate creation URL: /en/results/race-certificate-creation/ # Race certificate creation ### In the DistantRace platform, it is possible to automatically generate virtual certificates for finishers. ::: note Built-in design editor removed The manager no longer includes an in-browser certificate/diploma editor (background upload and drag-and-drop fields). Design your layout externally as a **PowerPoint (PPTX)** file and upload it — DistantRace fills the placeholder fields when generating each participant's document. ::: It’s quite simple to do. Here is a short instruction: #### 1. Open the race certificate view ![](/static/img/results/race-certificate-creation/image-1720337000561-23-08.png) In this view, you will be able to see all distances by blocks and download the PPTX file for the certificate design for each one. #### 2. Create the certificate design The certificate design must be created in PPTX format (Microsoft PowerPoint). Specific text fields in the design will be automatically replaced. ##### Automatic Fields Field | Race/Challenge | Description -- | --- | --- [EVENT NAME] | Race & Challenge | Event (Competition or Challenge) name [COMPETITION] | Race | Competition name [PARTICIPANT NAME] | Race & Challenge | Participant’s full name [Participant Name] | Race & Challenge | Participant’s full name formatted with each word starting with a capital letter [NR] | Race | Participant’s starting number [DISTANCE] | Race | Name of the race distance [GROUP] | Race & Challenge | Name of the participant’s group [TEAM] | Race & Challenge | Team name [FINISH DATE] | Race & Challenge | Date the race or challenge was completed [RESULT] | Race | Finish time in the format HH:MM:SS.m [CH_RESULT] | Race | Chip time in the format HH:MM:SS.m [P_D] | Race | Place in the distance [P_GR] | Race | Place in the group [C_D] | Race | Number of participants in the distance [C_GR] | Race | Number of participants in the group [AVG_SP] | Race | Average speed [LAP_0] | Race | Lap time 1 [LAP_1] | Race | Lap time 2 [LAP_2] | Race | Lap time 3 [LAP_3] | Race | Lap time 4 [LAP_4] | Race | Lap time 5 [TIME] | Challenge | Total time spent in the challenge [KM] | Challenge | Total kilometers covered [STEPS] | Challenge | Total number of steps [RANK] | Challenge | Overall result [GRANK] | Challenge | Group result [T P] | Challenge | Total points [T E] | Challenge | Total energy If a distance has more than five laps, additional lap fields continue the same pattern: `[LAP_5]`, `[LAP_6]`, and so on. ##### Design Samples Designs can be created in PowerPoint, but you can also use the service [canva.com](https://www.canva.com/templates/?query=race-certificate), where many race certificate designs are available: [https://www.canva.com/templates/?query=race-certificate](https://www.canva.com/templates/?query=race-certificate). ###### How to use canva.com to create a new design? 1. Choose a design from the available templates: [https://www.canva.com/templates/?query=race-certificate](https://www.canva.com/templates/?query=race-certificate) 2. Click “Customize this template” ![](/static/img/results/race-certificate-creation/image-1720349284386-47-46.png) 3. Once you have created the desired design and added the “automatic fields”, click “Share” -> “More”. ![](/static/img/results/race-certificate-creation/image-1720349371521-48-48.png) 4. In the list, select “Microsoft PowerPoint” and click “Download” ![](/static/img/results/race-certificate-creation/image-1720349435877-49-54.png) 5. This created design can now be added to distantrace.com and the created design sample can be viewed. ###### Some race certificate samples from canva.com Title | File | Sample ---- | --- | --- | [Colorful Modern Geometric Certificate of Participation](https://www.canva.com/p/templates/EAFyDmI-DqY-colorful-modern-geometric-certificate-of-participation/) | [File](https://media.distantrace.com/manager/examples/diploma/Colorful%20Modern%20Geometric%20Certificate%20of%20Participation.pptx) | [![Colorful%20Modern%20Geometric%20Certificate%20of%20Participation3.jpeg](/static/img/results/race-certificate-creation/colorful-20modern-20geometric-20certificate-20of-20participation3.jpeg)](https://media.distantrace.com/manager/examples/diploma/Colorful%20Modern%20Geometric%20Certificate%20of%20Participation3.jpeg) [Orange Geometric Challenger Certificate Marathon](https://www.canva.com/p/templates/EAEsYWJHo5w-orange-geometric-challenger-certificate-marathon/) | [File](https://media.distantrace.com/manager/examples/diploma/Orange%20Geometric%20Challenger%20Certificate%20Marathon.pptx) | [![Orange%20Geometric%20Challenger%20Certificate%20Marathon.jpeg](/static/img/results/race-certificate-creation/orange-20geometric-20challenger-20certificate-20marathon.jpeg)](https://media.distantrace.com/manager/examples/diploma/Orange%20Geometric%20Challenger%20Certificate%20Marathon.jpeg) ##### Adding Certificates to DistantRace ###### Deleting Certificates To delete a certificate, check the “Clear” field and click the “Save” button. ###### Publishing a Certificate If “Is Published?” is checked, a certificate will be automatically generated for the participant after results are added. ###### Adding a New PPTX File Click the “Browse…” button, select the certificate, and click “Save.” After clicking “Save,” a visual sample is automatically created - this can take up to a minute. If a specific font is used that displays incorrectly, please send the font to support@distantrace.com for it to be added to the system. ###### Generate Certificates for Participants If results are already added for participants, you can add a virtual certificate for participants by clicking “Save & Generate.” If the participant already has a certificate, it will be regenerated. ![](/static/img/results/race-certificate-creation/image-1720353696230-01-26.png) --- # Results bulk actions URL: /en/results/results-bulk-actions/ # Results bulk actions The competition **Results** list includes bulk operations beyond editing individual finishers. **Path:** Competition → **Results** → actions menu / export buttons ## Recalculate | Action | When to use | |--------|-------------| | **Recalculate places** | After manual time edits, status changes, or import fixes — rebuilds overall positions per distance | | **Recalculate points** | When standings use points rules — refreshes series or age-group point totals | Run recalculate after large corrections, not after every single edit. ## Result notification emails | Action | Effect | |--------|--------| | **Enable result sending** | Allows automatic result emails when results publish | | **Disable result sending** | Pauses outbound result messages | | **Send results** | Queues result emails to all finishers with published results | Configure message content in [Email templates](../integrations/email-templates-and-export.md). Sending runs as a background job. ## Spreadsheet and data exports | Export | Output | |--------|--------| | **Export XLSX** | Full results table for timing partners or archives | | **Export JSON-LD (OADM)** | Structured data export for federation or open-data feeds | Exports appear under [Organizer documents](../more-tools/organizer-documents.md) when ready. Full reference: [Exporting results data](exporting-results-data.md). ## PDF reports Generate printable PDFs from the results menu: - Overall results (all, top 20) - By gender - By distance - Progressive / most active - **Team results** (when team scoring is enabled) - **Standings** variants (overall, gender, groups, team) when series standings exist Custom PDF layouts may be available per club — files live in the club's custom export folder. ## Related - [Managing race results](managing-race-results.md) - [Publishing results](publishing-results.md) - [Standings and rankings](standings-and-rankings.md) - [Importing timing results](../running-events/importing-timing-results.md) --- # Standings and rankings URL: /en/results/standings-and-rankings/ # Standings and rankings **Standings** aggregate finisher results into overall, age-group, gender, and team rankings. **Path:** Open competition → **Standings** ## Standing types DistantRace computes standings per distance: - Overall (all finishers) - Age groups (from competition group settings) - Gender categories - Team standings (when teams are enabled) ## Manager view Select distance and standing type. The table shows rank, participant, time, and group. Export top 20 or full standings to Excel. ## Public page Published standings appear on the event's public results page. Customize columns in [Customizing results tables](../running-events/customizing-results-tables.md). ## After results change Standings recalculate when results are added or edited. Re-importing timing data may require a refresh before publishing. ## Related - [Managing race results](managing-race-results.md) - [Customizing results tables](../running-events/customizing-results-tables.md) --- # Running events URL: /en/running-events/ # Running events Use this section if you **organize** sports challenges and competitions on DistantRace. ## Get started 1. [Event types overview](event-types-overview.md) 2. [Create a club](create-a-club.md) 3. [Access the organizer console](access-the-organizer-console.md) ## Create an event | Type | Guide | |------|-------| | Wizard (all types) | [Create event wizard](create-event-wizard.md) | | Step challenge | [Create a step challenge](create-a-step-challenge.md) | | Sports activity (run, bike, active days) | [Create a sports activity challenge](create-a-sports-activity-challenge.md) | | Combined challenge | [Combined challenges](combined-challenges.md) | | Points challenge | [Points challenges](points-challenges.md) | | Virtual competition | [Create a virtual competition](create-a-virtual-competition.md) | | In-person race | [Create an in-person race](create-an-in-person-race.md) | ## Configure and share - [Club home dashboard](club-home-dashboard.md) - [Competition dashboard analytics](competition-dashboard-analytics.md) - [Challenge dashboard analytics](challenge-dashboard-analytics.md) - [Copying a challenge](copying-a-challenge.md) - [Event internal comments](event-internal-comments.md) - [Challenge settings walkthrough](challenge-settings-walkthrough.md) — guided setup after creation - [Challenge settings reference](challenge-settings-reference.md) — all settings explained - [Challenge default virtual paths](challenge-default-virtual-paths.md) - [Challenge display settings](challenge-display-settings.md) - [Event info pages and regulations](event-info-pages-and-regulations.md) - [Registration form questions](registration-form-questions.md) - [Event translations and localization](event-translations-and-localization.md) - [Age groups and standings groups](age-groups-and-standings-groups.md) - [Accepting a club admin invitation](accepting-a-club-admin-invitation.md) - [Step game](step-game.md) - [Advanced challenge settings](advanced-challenge-settings.md) - [Challenge rules and activity limits](challenge-rules-and-activity-limits.md) - [Share your event (Easy Access)](share-your-event-easy-access.md) - [Join codes and invitations](join-codes-and-invitations.md) ## Manage participants and race day - [Managing challenge participants](managing-challenge-participants.md) - [Exporting challenge data](exporting-challenge-data.md) - [Exporting step challenge daily results](exporting-step-challenge-daily-results.md) - [Managing the start list](managing-the-start-list.md) - [Virtual competition start list](virtual-competition-start-list.md) - [Managing individual racers](managing-individual-racers.md) - [Importing start list from spreadsheet](importing-start-list-from-spreadsheet.md) - [Season pass and multi-stage competitions](season-pass-and-multi-stage-competitions.md) - [Bib number management](bib-number-management.md) - [Checkpoint passages](checkpoint-passages.md) - [Race-day registration and check-in](race-day-registration-and-check-in.md) - [Mobile ticket scanning for organizers](mobile-ticket-scanning-for-organizers.md) - [Importing timing results](importing-timing-results.md) - [Results URL sync](results-url-sync.md) - [Competition distance sync mapping](competition-distance-sync-mapping.md) - [On-site payment and in-store registration](on-site-payment-and-in-store-registration.md) - [Collecting interested participants](collecting-interested-participants.md) - [Reviewing virtual workouts](reviewing-virtual-workouts.md) - [Managing competition teams](managing-competition-teams.md) - [Competition club teams](competition-club-teams.md) - [Event history and audit log](event-history-and-audit-log.md) ## Club, payments, and partners - [Club settings and admins](club-settings-and-admins.md) - [Whitelabel and enterprise setup](whitelabel-and-enterprise-setup.md) - [Competition settings reference](competition-settings-reference.md) - [Competition advanced settings](competition-advanced-settings.md) - [Club billing from DistantRace](club-billing-from-distantrace.md) - [Costs and pricing](costs-and-pricing.md) - [Upgrading participant limits](upgrading-participant-limits.md) - [Managing tickets and pricing](managing-tickets-and-pricing.md) - [Managing orders and carts](managing-orders-and-carts.md) - [Reserved entries](reserved-entries.md) - [Yearly income export](../finance-module/yearly-income-export.md) - [Premium registration packages](premium-registration-packages.md) - [CO₂, energy, and team challenges](co2-energy-and-team-challenges.md) - [Virtual competition sport variants](virtual-competition-sport-variants.md) - [Upsell products in checkout](upsell-products-in-checkout.md) - [Managing Omniva shipments](managing-omniva-shipments.md) - [Partner and corporate registration](partner-and-corporate-registration.md) - [Marketing to participants](marketing-to-participants.md) - [Marketing email export filters](marketing-email-export-filters.md) - [Shop bought products list](shop-bought-products-list.md) ## Related sections - [Finance module](../finance-module/introduction-to-the-finance-module.md) - [Results and certificates](../results/index.md) - [Integrations](../integrations/introduction-to-integrations.md) - [More tools](../more-tools/index.md) --- # Accepting a club admin invitation URL: /en/running-events/accepting-a-club-admin-invitation/ # Accepting a club admin invitation Club owners invite teammates by email. Invitees accept through a link and gain access to the manager console. ## Receive the invitation An administrator sends the invite from **Club → Members → Invite** — see [Club settings and admins](club-settings-and-admins.md). The email contains a link to: `/console/invite//` ## Accept the invitation 1. Open the link from the email 2. **Sign in** to DistantRace (or create an account if you are new) 3. Review which club invited you and the access level (Administrator, Finance, Support, or Ticket scan) 4. Click **Accept** You are redirected to that club's manager console home page. ## Access levels | Role | What you can do | |------|-----------------| | **Administrator** | Full organizer console | | **Finance** | Payments, invoices, orders — no operational event editing | | **Support team** | Start lists, results, participants — no financial summaries | | **Ticket scan** | Mobile app scanning only | ## Troubleshooting | Issue | Fix | |-------|-----| | Link says sign in required | Log in with the same email the invite was sent to | | Invitation not found | Ask the club admin to resend from **Club → Members** | | Wrong permissions after accepting | Club admin can change your role on the Members page | ## For club administrators - **Resend** — pending invites can be resent from the Members table - **Delete invitation** — revoke a pending invite before it is accepted - **Remove member** — revoke access after acceptance ## Related - [Access the organizer console](access-the-organizer-console.md) - [Sign-in options](../joining-events/sign-in-options.md) --- # How to access the organizer console URL: /en/running-events/access-the-organizer-console/ # How to access the organizer console DistantRace has two sides: the **public site** for participants and the **manager console** for organizers. ## Open the console 1. Log in at [distantrace.com](https://distantrace.com) 2. Click **Competition management** (or **Manager**) in the menu 3. Select your **club** if you belong to several Direct URL pattern: `/console//` ## Console map ### Club level | Area | Guide | |------|-------| | Create event | [Create event wizard](create-event-wizard.md) · [Event types overview](event-types-overview.md) | | Club settings & admins | [Club settings and admins](club-settings-and-admins.md) | | Accept admin invite | [Accepting a club admin invitation](accepting-a-club-admin-invitation.md) | | Subscription | [Club subscription management](club-subscription-management.md) | | Integrations | [Introduction to integrations](../integrations/introduction-to-integrations.md) | | Embed domains | [Embed domains for iframes](embed-domains-for-iframes.md) · [Whitelabel and enterprise setup](whitelabel-and-enterprise-setup.md) | | Club join codes | [Club-wide join codes](club-wide-join-codes.md) | | Club dashboard | [Club home dashboard](club-home-dashboard.md) | | Interested leads | [Collecting interested participants](collecting-interested-participants.md) | | Club billing (platform invoices) | [Club billing from DistantRace](club-billing-from-distantrace.md) | | Finance | [Finance module](../finance-module/introduction-to-the-finance-module.md) | | Marketing | [Marketing to participants](marketing-to-participants.md) · [Marketing email export filters](marketing-email-export-filters.md) | | Yearly income | [Yearly income export](../finance-module/yearly-income-export.md) | | Shop products | [Upsell products in checkout](upsell-products-in-checkout.md) · [Shop bought products list](shop-bought-products-list.md) | | Documents | [Organizer documents](../more-tools/organizer-documents.md) | | More tools | [More tools hub](../more-tools/index.md) — exports, CSV import, merge duplicates | ### Challenge dashboard | Tab / area | Guide | |------------|-------| | Overview walkthrough | [Challenge settings walkthrough](challenge-settings-walkthrough.md) | | Dashboard analytics | [Challenge dashboard analytics](challenge-dashboard-analytics.md) | | Copy challenge | [Copying a challenge](copying-a-challenge.md) | | Internal comments | [Event internal comments](event-internal-comments.md) | | All settings | [Challenge settings reference](challenge-settings-reference.md) | | Pages & regulations | [Event info pages and regulations](event-info-pages-and-regulations.md) | | Registration questions | [Registration form questions](registration-form-questions.md) | | Event Customization | [Event translations and localization](event-translations-and-localization.md) | | Age groups | [Age groups and standings groups](age-groups-and-standings-groups.md) | | Advanced settings | [Advanced challenge settings](advanced-challenge-settings.md) | | Step game | [Step game](step-game.md) | | Virtual map presets | [Challenge default virtual paths](challenge-default-virtual-paths.md) | | Display settings | [Challenge display settings](challenge-display-settings.md) | | Participants | [Managing challenge participants](managing-challenge-participants.md) | | Participant detail | [Editing individual challenge participants](editing-individual-challenge-participants.md) | | Workouts | Activity review; exports: [Exporting challenge data](exporting-challenge-data.md) · [Exporting step challenge daily results](exporting-step-challenge-daily-results.md) | | Teams | [Managing challenge team standings](managing-challenge-team-standings.md) | | Stage standings | [Challenge stages and section standings](challenge-stages-and-section-standings.md) | | History | [Event history and audit log](event-history-and-audit-log.md) | | Upgrade slots | [Upgrading participant limits](upgrading-participant-limits.md) | | Danger zone | [Event danger zone](event-danger-zone.md) | ### Competition dashboard | Tab / area | Guide | |------------|-------| | Settings | [Competition settings reference](competition-settings-reference.md) | | Sports *(virtual)* | [Competition sports settings](competition-sports-settings.md) | | Dashboard analytics | [Competition dashboard analytics](competition-dashboard-analytics.md) | | Advanced | [Competition advanced settings](competition-advanced-settings.md) | | Season pass / stages | [Season pass and multi-stage competitions](season-pass-and-multi-stage-competitions.md) | | Start list | [Managing the start list](managing-the-start-list.md) · [Virtual competition start list](virtual-competition-start-list.md) | | CSV import | [CSV importer](../more-tools/csv-importer.md) | | Results import | [Importing timing results](importing-timing-results.md) · [Results URL sync](results-url-sync.md) · [Distance sync mapping](competition-distance-sync-mapping.md) | | Tickets & pricing | [Managing tickets and pricing](managing-tickets-and-pricing.md) | | Orders | [Managing orders and carts](managing-orders-and-carts.md) | | Reserved entries | [Reserved entries](reserved-entries.md) | | Workouts *(virtual)* | [Reviewing virtual workouts](reviewing-virtual-workouts.md) | | Results & standings | [Results](../results/index.md) · [Standings and rankings](../results/standings-and-rankings.md) | | Teams | [Managing competition teams](managing-competition-teams.md) · [Competition club teams](competition-club-teams.md) | | History | [Event history and audit log](event-history-and-audit-log.md) | | Numbers / bibs | [Bib number management](bib-number-management.md) | | Race day | [Race-day registration and check-in](race-day-registration-and-check-in.md) | | Ticket scanning | [Mobile ticket scanning for organizers](mobile-ticket-scanning-for-organizers.md) | | On-site payment | [On-site payment and in-store registration](on-site-payment-and-in-store-registration.md) | | Shipping | [Managing Omniva shipments](managing-omniva-shipments.md) | | Reviews | [Participant event reviews](participant-event-reviews.md) | ## Permissions Club **administrators** see everything. **Finance** staff see payments only. **Support** staff see operations without financial summaries. **Ticket scan** role is mobile app only — [Club settings and admins](club-settings-and-admins.md). ## Related - [Create a club](create-a-club.md) - [Running events hub](index.md) --- # Advanced challenge settings URL: /en/running-events/advanced-challenge-settings/ # Advanced challenge settings **Path:** Challenge dashboard → Settings → **Advanced** These options fine-tune scoring, visibility, and participation rules. Which fields appear depends on **challenge type** — the form hides irrelevant options automatically. See also the [challenge settings reference](challenge-settings-reference.md) for all other settings sections. ## Field availability by challenge type | Field | Step | Sports / distance / geo / time / calorie / CO₂ / charity / shape | Active days | Combined | |-------|:----:|:------------------------------------------------------------------:|:-----------:|:--------:| | Result ordering | ✓* | ✓* | ✓* | ✓* | | Energy unit (kcal / kWh) | — | ✓ | ✓ | ✓ | | Daily step threshold (`move_amount`) | ✓ | — | — | — | | Step point tiers | ✓ | — | — | — | | Active-day threshold (`move_amount` + unit) | — | — | ✓ | ✓ | | Daily steps threshold (`move_amount_steps`) | — | — | — | ✓ | | CO₂ per km | — | ✓ | ✓ | ✓ | | Accept manual workouts | — | ✓ | ✓ | ✓ | | Child subaccounts | — | ✓ | ✓ | ✓ | | Allow multiple distances | — | ✓† | — | — | | Top results in team | ✓‡ | ✓‡ | ✓‡ | ✓‡ | | Results hidden from / till | ✓ | — | — | — | | Disable daily email | ✓ | — | — | — | | External signup URL | ✓ | ✓ | ✓ | ✓ | \* **Result ordering** appears only when the challenge uses a single primary sort field (not multi-column or ascending sort). Hidden when standings use composite ordering. † **Allow multiple distances** — only on **distance-kind** challenges with at least one published distance. ‡ **Top results in team** — only when teams are enabled. --- ## Result ordering **Field:** `ordering` **Applies when:** Single-field descending sort is used. Primary column for the public leaderboard and rank calculation: | Value | Sorts by | |-------|----------| | Steps | Total steps (`-steps_done`) | | Distance | Total distance (`-distance_done`) | | Time | Total moving time (`-time_spent`) | | Energy | Calories (`-calories_done`) | | Points / Active days | Points total (`-points_total`) — label is **Active days** for active-day challenges, **Points** for geo, combined, or points-calculated sports challenges | Changing ordering recalculates all challenger ranks after save. --- ## Energy unit **Field:** `energy_display` **Applies to:** All non-step challenges. | Option | Display | |--------|---------| | Kilocalories | kcal on results and activity summaries | | Kilowatt-hours | kWh (useful for energy-themed challenges) | --- ## Daily step threshold (step challenges) **Field:** `move_amount` **Applies to:** Step challenges only. Minimum steps per calendar day to score points when **step point tiers** are not used, or as the base daily target shown to participants. Set to `0` to disable a fixed daily floor and rely entirely on tiers. --- ## Step point tiers (step challenges) **Field:** `step_points_tiers` **Applies to:** Step challenges only. Award **points per calendar day** based on how many steps the participant reaches. Format — comma-separated pairs: ```text 6000:1, 8000:2, 10000:3 ``` Meaning: 6 000+ steps → 1 point; 8 000+ → 2 points; 10 000+ → 3 points. Thresholds must increase; points must not decrease. Leave empty to use a flat scoring model from `move_amount` and the [step game](step-game.md) instead. --- ## Active-day threshold (active-day & combined challenges) **Fields:** `move_amount` + `move_kind` **Applies to:** Active-day challenges and combined challenges. Defines what counts as one **active day** (awards 2 points per active day in combined scoring): | Unit | Example | |------|---------| | Minutes | 30 minutes of activity | | Kilocalories | 300 kcal burned | | Kilometers | 5 km distance | --- ## Daily steps threshold (combined challenges only) **Field:** `move_amount_steps` **Applies to:** Combined challenges only. Minimum steps on a calendar day to award **1 bonus point** (in addition to active-day points from sports). Default: 10 000. Combined scoring = active-day rule + daily steps rule + [step game](step-game.md) tasks + accepted sports workouts. --- ## CO₂ per km **Field:** `co2` **Applies to:** Non-step challenges. **Default:** 0.2 (kg CO₂ saved per km). Used on eco / CO₂-themed challenges to estimate carbon savings from participant distance. Shown on results when the challenge displays environmental impact. --- ## Accept manual workouts **Field:** `accept_manual_workouts` **Applies to:** Non-step challenges. When enabled, participants can submit **manual activities** (no GPS file) that organizers or rules can accept. Stored as `accept_unknown` on the challenge. Pair with [challenge rules](challenge-rules-and-activity-limits.md) — manual entries still pass validation when accepted. --- ## Child subaccounts **Field:** `subaccounts` **Applies to:** Non-step challenges. Allows parents to register **children below the minimum age** as sub-accounts: 1. Parent creates a DistantRace account 2. Parent adds a child sub-account and registers them 3. Parent connects a sports app 4. Parent submits each child activity manually from **Profile → My Activities → activity detail** Children do not sync activities independently until they have their own account. --- ## Allow multiple distances **Field:** `allow_multiple_distances` **Applies to:** Distance-kind challenges with published distances. Lets one participant enroll in **more than one distance** within the same challenge. See [Multi-distance challenges](multi-distance-challenges.md). --- ## Top results in team **Field:** `top_in_team` **Applies when:** Teams enabled. Limits how many **top individual results** count toward each team's total. Prevents one super-active member from carrying the entire team score. Uses the same metric as **result ordering** for ranking contributors within the team. --- ## Results hidden from / till (step challenges) **Fields:** `results_hidden_from`, `results_hidden_till` **Applies to:** Step challenges only. **Timezone:** Club timezone. Temporarily **hide the public leaderboard** between these datetimes — useful for surprise announcements or end-of-challenge reveals. `hidden_from` must be before `hidden_till`. Leave blank to show results normally. --- ## Disable daily email (step challenges) **Field:** `daily_email_disabled` **Applies to:** Step challenges only. Turns off automated **daily summary emails** to participants (step totals, rank changes). Marketing campaigns are unaffected. --- ## External signup URL **Field:** `signup_url` **Applies to:** All challenge types. Optional HTTPS link shown to participants as an external **paid registration** path (white-label clients). Leave blank for standard free DistantRace apply flow. --- ## After saving Saving advanced settings triggers **result recalculation** for all participants (and team totals where applicable). Large challenges may take a minute to update standings. ## Related - [Combined challenges](combined-challenges.md) - [Step game](step-game.md) - [Challenge rules and activity limits](challenge-rules-and-activity-limits.md) - [Competition advanced settings](competition-advanced-settings.md) — parallel page for races --- # Age groups and standings groups URL: /en/running-events/age-groups-and-standings-groups/ # Age groups and standings groups **Groups** split standings and start lists by age and gender — for example M40, F30, or youth categories. **Path (challenge):** Challenge → Settings → **Groups** **Path (competition):** Competition → Settings → select a distance → **Groups** ## Club-level group collections Groups are stored as **collections** at club level. Each collection contains one or more ranges: | Field | Meaning | |-------|---------| | **Title** | Label shown in standings (e.g. M40–49) | | **From / till year** | Birth years included in the group | | **Gender** | Male, female, or all | Create a new collection on the Groups settings page, or pick an existing club collection and attach it to the event. ## Attach groups to an event ### Challenges One group collection applies to the whole challenge. Standings can filter by group when groups are configured. ### Competitions Groups are configured **per distance**. A marathon and a 10K can use different collections or share one. After saving groups while the event is open, DistantRace **recalculates** group assignments and standings in the background. ## Edit or remove groups - **Save group** — add or update a range inside the active collection - **Delete group** — remove one range - **Delete collection** — remove the whole collection from the event (does not delete the club-level template) - **Delete groups** — detach all groups from the event entirely ::: warning Event ended Changing groups after an event ends may not recalculate historical standings. Prefer finalizing groups before publishing results. ::: ## Where participants see groups - Public standings tables with a group filter - Start lists when age groups are enabled - Challenge leaderboards with group tabs Participant view: [Viewing competition standings and team results](../joining-events/viewing-competition-standings-and-team-results.md). ## Related - [Challenge settings reference](challenge-settings-reference.md) — Groups section - [Competition settings reference](competition-settings-reference.md) — Groups section - [Standings and rankings](../results/standings-and-rankings.md) - [Create a step challenge](create-a-step-challenge.md) — age group screenshots --- # Bib number management URL: /en/running-events/bib-number-management/ # Bib number management Assign **bib numbers** to in-person race participants. **Path:** Competition → **Numbers** ## Number pools Define pools (ranges or sets) per distance or category. Generate available numbers before the event. ## Assign to participants Assign numbers individually from the start list or in bulk from the Numbers section. ## Race-day bulk assign **Race day → Assign numbers** assigns bibs to paid registrants on event morning. Changes are logged in the event history. ## Participant view Assigned numbers appear on confirmations and in the participant's account where enabled. ## Related - [Managing the start list](managing-the-start-list.md) - [Checkpoint passages](checkpoint-passages.md) — scan bibs at checkpoints --- # Challenge dashboard analytics URL: /en/running-events/challenge-dashboard-analytics/ # Challenge dashboard analytics The **challenge dashboard** gives a quick overview of signups and paid registrations while the challenge runs. **Path:** Challenge → dashboard (home tab) ## Registration chart A time-series chart shows **new challenge participants** per day for the date range you select. Use it to: - Measure the impact of [Easy Access](share-your-event-easy-access.md) or email campaigns - Spot drop-off after the first week of a long challenge - Report engagement to corporate wellness sponsors ## Income chart If the challenge charges a registration fee, an **income chart** plots daily payment totals. Finance staff can compare this with [purchase summaries](../finance-module/purchase-summary.md). Free challenges show registration counts only. ## Sports and step connections Like competitions, the dashboard can show which **connected apps** participants use — Garmin for workouts, Apple Health for steps, etc. Prioritize [sync troubleshooting](../connections-with-apps/data-synchronization-problems/the-most-common-reasons-for-data-synchronization-issues.md) for the most common providers. ## Internal comments Staff can leave **internal comments** on the dashboard — notes visible only to organizers, not participants. Use for handover between race directors ("check team X on Monday"). ## Exports Participant and step exports live on the **Participants** and **Workouts** tabs — [Exporting challenge data](exporting-challenge-data.md). ## Related - [Managing challenge participants](managing-challenge-participants.md) - [Challenge settings walkthrough](challenge-settings-walkthrough.md) - [Competition dashboard analytics](competition-dashboard-analytics.md) --- # Challenge default virtual paths URL: /en/running-events/challenge-default-virtual-paths/ # Challenge default virtual paths When setting up a virtual route, choose from **preset maps** instead of uploading your own GPX. **Path:** Challenge → **Default virtual path** (shown when no custom map exists yet) ## Pick a preset 1. Browse published default routes (curated GPX tracks) 2. Select one — it copies to your challenge as the virtual map 3. Customize start/end place names under Settings → **Virtual map** ## Custom upload To use your own track, go to Settings → **Virtual map** and upload GPX or draw the path — see [Challenge settings reference](challenge-settings-reference.md#virtual-map). ## Related - [Challenge goals and milestones](challenge-goals-and-milestones.md) - [Virtual map progress](../joining-events/virtual-map-progress.md) (participant view) --- # Challenge display settings URL: /en/running-events/challenge-display-settings/ # Challenge display settings **Path:** Challenge → Settings → **Display of results** ## Participant table columns Toggle visibility for each metric: steps, distance, time, calories, points, sport breakdowns, team, group, etc. Hidden columns remain in the manager view. ## Team table columns Parallel toggles for team standings — aggregate score, member count, progress percentage. ## Public vs embedded Changes apply to: - Challenge public **Results** tab - [Embedded iframes](embedding-results-on-your-website.md) ## Related - [Customizing results tables](customizing-results-tables.md) — competitions - [Advanced challenge settings](advanced-challenge-settings.md) — hide results by date (step challenges) --- # Challenge goals and milestones URL: /en/running-events/challenge-goals-and-milestones/ # Challenge goals and milestones **Path:** Challenge → Settings → **Goals** ## Goal types | Type | Example | |------|---------| | **Collective** | Club walks 1 000 000 steps together | | **Individual** | Each participant reaches 100 km | | **Team** | Team totals 500 active days | Goals appear on the public challenge page and in participant progress views. ## Along the virtual map When a [virtual map](challenge-settings-reference.md#virtual-map) is configured, place **milestones** on the route — participants unlock achievements as the group progresses. ## Step game overlap [Step game](step-game.md) handles **daily sequential tasks**; Goals handle **cumulative targets**. Both can run on the same challenge. ## Related - [Challenge default virtual paths](challenge-default-virtual-paths.md) - [After joining a challenge](../joining-events/after-joining-a-challenge.md) --- # Challenge rules and activity limits URL: /en/running-events/challenge-rules-and-activity-limits/ # Challenge rules and activity limits **Settings → Rules** (sports activity challenges) defines which workouts count toward results. ## GPS requirement | Setting | Effect | |---------|--------| | GPS required | Only activities with GPS track count | | GPS optional | Activities with or without GPS | | No GPS | Non-GPS activities allowed | Important for virtual-style efforts inside challenges. ## Sync timing - **Hours after end** — how long after the challenge ends synced activities still count - **Sync offset** — ignore workouts synced too late after they occurred ## Activity before join **Count past activities** — include workouts recorded before the participant registered (within challenge dates). ## Per-activity limits Minimum and maximum: - Duration - Distance - Energy - Steps ## Daily acceptance - **Max activities per day** — cap how many count - **Order** — which activities rank when over the limit (longest, shortest, first synced, etc.) ## Participant troubleshooting When activities are excluded, participants see reasons on the activity detail page. Share [Why activities are missing](../joining-events/why-activities-are-missing.md). Organizers can accept individual workouts from **Participants → Workouts**. --- # Challenge settings reference URL: /en/running-events/challenge-settings-reference/ # Challenge settings reference Open **Settings** from the challenge dashboard. Available sections depend on challenge type. ## Base settings **Path:** Settings → Base | Field | Description | |-------|-------------| | Start / End | Event window in your club timezone | | Status | Published, unpublished, or cancelled | | Access | Public, club members, unlisted, or private | | Join password | Single shared password when private without individual codes | ## Event Customization **Path:** Settings → **Event Customization** Per-language **name**, **description**, **images**, **logo**, **main goal**, and **place name**. ## Teams Enable teams; choose participant-created or organizer pre-defined teams. Set how many top results count per team. ## Sports *(non-step challenges)* Drag-and-drop **accepted sports**, points per km, sport aliases, and per-sport result columns. ## Rules *(sports challenges)* GPS requirement, sync window after event end, min/max activity size, daily acceptance limits, whether activities before join date count. See [Challenge rules and activity limits](challenge-rules-and-activity-limits.md). ## Stages Named time periods with optional separate goals and standings (monthly winners, etc.). ## Distances *(distance-kind challenges)* Multiple enrollment distances, caps per distance, multi-distance registration. See [Multi-distance challenges](multi-distance-challenges.md). ## Groups Age/gender groups for filtered standings. See [Age groups and standings groups](age-groups-and-standings-groups.md). ## Pages Info pages, after-apply pages, and mandatory regulations with consent checkbox. See [Event info pages and regulations](event-info-pages-and-regulations.md). ## Questions Custom registration fields: text, choice, yes/no, number, team choice. See [Registration form questions](registration-form-questions.md). ## Registration Registration start/end, minimum and maximum birth year. ## Join passwords Per-event individual codes with optional prefill and email invitations. See [Join codes and invitations](join-codes-and-invitations.md). ## Location *(sports challenges)* Geo-fenced allowed or forbidden areas on a map. See [Geo location restrictions](geo-location-restrictions.md). ## Virtual map Upload or select GPX route; start/end place names; user vs team progress on map. Pick from preset routes first — [Challenge default virtual paths](challenge-default-virtual-paths.md). Column visibility: [Challenge display settings](challenge-display-settings.md). ## Goals Collective, individual, and team targets with units (steps, km, time, etc.). ## Step game Daily tasks — see [Step game](step-game.md). ## Display of results Toggle columns on participant and team result tables. See [Customizing results tables](customizing-results-tables.md). ## Iframe embedding Allowed domains and embed URLs for results pages. See [Embedding results on your website](embedding-results-on-your-website.md). ## Advanced Result ordering, energy units, CO₂ factor, active-day thresholds, step point tiers, results hidden windows, manual workout acceptance, external signup URL, child subaccounts. See [Advanced challenge settings](advanced-challenge-settings.md) — **complete field reference by challenge type**. ## Danger zone Cancel or permanently delete the event — [Event danger zone](event-danger-zone.md). ## Participant operations | Task | Guide | |------|-------| | List & export | [Managing challenge participants](managing-challenge-participants.md) | | Edit one person | [Editing individual challenge participants](editing-individual-challenge-participants.md) | | Team standings | [Managing challenge team standings](managing-challenge-team-standings.md) | | Stage standings | [Challenge stages and section standings](challenge-stages-and-section-standings.md) | | Reviews | [Participant event reviews](participant-event-reviews.md) | ## Competition settings In-person and virtual **competitions** use a parallel settings menu — [Competition settings reference](competition-settings-reference.md). --- # Challenge settings walkthrough URL: /en/running-events/challenge-settings-walkthrough/ # Challenge settings walkthrough After you create a challenge, DistantRace opens the **settings walkthrough** — a step-by-step tour of the most important configuration. Reopen it anytime from **Settings → Walkthrough**. URL: `/console//challenges//overview/` (add `?new=1` right after creation). ## Walkthrough steps The tour adapts to your challenge type. Steps you may see: ### 1. Overview and Easy Access - Event QR code and short join code - Share link and per-language [onboarding URLs](../joining-events/challenge-onboarding-page.md) - Link to [Easy Access](share-your-event-easy-access.md) for full sharing options ### 2. Rules Summary of main goal, accepted sports, and scoring rules. Edit rules in **Settings → Rules**. ### 3. Participant slots Shows used vs allowed participant count. Upgrade your plan if you need more slots — [Costs and pricing](costs-and-pricing.md). ### 4. Dates Event start and end. Adjust in **Settings → Base**. ### 5. Languages Configured language versions. Add translations in **Settings → Event Customization** — [Event translations and localization](event-translations-and-localization.md). ### 6. Teams Choose **no teams**, **pre-defined teams**, or **open teams** (participants create their own). Configure in **Settings → Teams**. ### 7. Sports *(sports challenges only)* Accepted sports and points per km. Not shown for pure step challenges. ### 8. Step game *(step and combined challenges)* Daily tasks and scoring toggle. See [Step game](step-game.md). ### 9. Points *(step, move, combined)* Links to step tiers, daily step thresholds, and sport points. ### 10. Virtual map Whether a GPX route is configured for progress visualization. ### 11. Goals Individual, team, and collective targets. ### 12. Advanced / registration hub Shortcuts to registration window, questions, groups, result display, and stages. ### 13. Finish Tour complete — open the challenge dashboard. ## Full reference Every setting is documented in [Challenge settings reference](challenge-settings-reference.md). --- # Challenge stages and section standings URL: /en/running-events/challenge-stages-and-section-standings/ # Challenge stages and section standings When a challenge has **stages** (Settings → Stages), standings can be viewed **per stage** as well as overall. ## Configure stages **Path:** Settings → **Stages** Create named periods (e.g. Week 1, February) with optional separate goals. See [Challenge settings reference → Stages](challenge-settings-reference.md#stages). ## Section participant standings **Path:** Challenge → Participants → **Section** filter or `/section//` URL Shows the same columns as the main leaderboard but counts only activities within the selected stage dates. Export section results to XLSX from the participants table. ## Section team standings **Path:** Challenge → Teams → section view Team totals recalculated for the stage window only — useful for monthly team prizes. ## Display Enable stage columns on public results in [Customizing results tables](customizing-results-tables.md). ## Related - [Multi-distance challenges](multi-distance-challenges.md) — distance caps per stage - [Managing challenge team standings](managing-challenge-team-standings.md) --- # Checkpoint passages URL: /en/running-events/checkpoint-passages/ # Checkpoint passages **Passages** track participants through checkpoints on course — useful for lap races, triathlon segments, or confirming kit pickup. **Path:** Competition → **Passage** ## Record scans Scan participant QR codes or bib barcodes at checkpoints. Each scan creates a passage record with timestamp. ## Pre-passages **Passage → Pre** configures expected passage order or pre-registration at checkpoints before race day. ## Race-day registration QR Participants who register on race day receive a QR code by email. Scan it at the registration tent to confirm payment and assign a bib — see [Race-day registration and check-in](race-day-registration-and-check-in.md). ## Related - [Managing the start list](managing-the-start-list.md) - [Bib number management](bib-number-management.md) --- # Club billing from DistantRace URL: /en/running-events/club-billing-from-distantrace/ # Club billing from DistantRace Separate from **participant registration invoices** (money your club collects), this area shows what **your club pays DistantRace** for platform services. **Path:** Manager console → Club → **Billing history** ## What appears here - Monthly **Pro / Pro+ subscription** invoices - One-time **participant slot upgrades** ([Invoices for platform services](../finance-module/invoices-for-platform-services.md)) - Other platform charges billed to your club's Stripe customer ## vs participant invoices | View | Who pays whom | |------|----------------| | **Billing history** (club settings) | Club → DistantRace | | [Finance → Invoices](../finance-module/invoicing.md) | Participant → Club | ## Related - [Club subscription management](club-subscription-management.md) - [Costs and pricing](costs-and-pricing.md) --- # Club branding and hero images URL: /en/running-events/club-branding-and-hero-images/ # Club branding and hero images **Hero images** are large banner images on your public club page, whitelabel participant portals, and in some email templates. **Path:** Manager console → Marketing → **Hero images** (whitelabel clubs only) ::: note Whitelabel portals Hero images are also exposed through the REST API (`/api/v1/orgs/hero-images/`) for branded participant sites. See [Whitelabel and enterprise setup](whitelabel-and-enterprise-setup.md). ::: ## Upload images 1. Hero images → **Create** 2. Upload image (wide landscape format works best) 3. Set alt text for accessibility 4. Optional **link URL** — where the banner clicks through (event page, registration, external site) 5. **Sort order** — lower numbers appear first in rotation ## Multiple heroes Add several images to rotate or highlight different events. Reorder by changing sort values. ## Club logo The club **logo** is set under Club → Settings, not in hero images. It appears in navigation and emails separately. ## Related - [Whitelabel and enterprise setup](whitelabel-and-enterprise-setup.md) - [Club settings and admins](club-settings-and-admins.md) - [Marketing to participants](marketing-to-participants.md) --- # Club home dashboard URL: /en/running-events/club-home-dashboard/ # Club home dashboard When you open a club in the manager console, the **home dashboard** summarizes club health before you drill into individual events. **Path:** `/console//` ## Active events The dashboard lists **active events** — competitions and challenges that ended within the last few days or are still running. Click an event to open its dashboard. ## Participant growth chart A time-series chart shows **new club participants** per day for a date range you select. Use it to: - Spot registration spikes after marketing campaigns - Compare pre-event vs race-week signup velocity - Report growth to sponsors or partners ## Income chart Users with **finance** permission see an **income chart** — card and online payments received per day for the selected period. Totals at the start and end of the range help reconcile against [purchase summaries](../finance-module/purchase-summary.md) and [online payment transactions](../finance-module/online-payment-transactions.md). ::: note Finance role required Income data is hidden from support-only staff. See [Club settings and admins](club-settings-and-admins.md). ::: ## Connection breakdown Two summary blocks show how participants sign in and sync data: | Block | Shows | |-------|-------| | **Social logins** | Share of Google, Facebook, Apple sign-ins | | **Sports apps** | Share of Garmin, Polar, Suunto, Fitbit, and other connected services | Use this when troubleshooting [data sync issues](../connections-with-apps/data-synchronization-problems/the-most-common-reasons-for-data-synchronization-issues.md) — if most participants use one provider, prioritize support docs for that app. ## Related - [Competition dashboard analytics](competition-dashboard-analytics.md) - [Challenge dashboard analytics](challenge-dashboard-analytics.md) - [Club billing from DistantRace](club-billing-from-distantrace.md) --- # Club settings and admins URL: /en/running-events/club-settings-and-admins/ # Club settings and admins Manage your organizer **club** (organization) profile and team access. ## Club information **Club → Settings** | Field | Purpose | |-------|---------| | Club email | Public contact for participants | | Timezone | Default for all event start/end times | | Country | Primary operating country | | Logo | Branding on club page | ### Billing data Required for invoices and paid events: - Billing name, company number, VAT, address - Bank name, bank code, account number ![](/static/img/introduction-to-organizing-competitions/how-to-change-club-information/image-1712177429764-49-42.png) ## Add administrators **Club → Members** — invite by email with access level: | Role | Access | |------|--------| | Administrator | Full rights | | Finance | Finances only — invoices, orders, payment channels, bank | | Support team | Operations without financial summaries — start list, results, participants | | Ticket scan | Mobile app ticket scanning only — [Mobile ticket scanning](mobile-ticket-scanning-for-organizers.md) | Invite via **Club → Members → Invite**. Pending invites can be **resent** or **deleted** from the same page. Invitees accept through the email link — [Accepting a club admin invitation](accepting-a-club-admin-invitation.md). See [Sign-in options](../joining-events/sign-in-options.md) for how invitees log in. ![](/static/img/introduction-to-organizing-competitions/how-to-add-additional-administrators-to-a-club/image-1712213287493-47-49.png) ## Related - [Create a club](create-a-club.md) - [Costs and pricing](costs-and-pricing.md) - [Finance module](../finance-module/introduction-to-the-finance-module.md) --- # Club subscription management URL: /en/running-events/club-subscription-management/ # Club subscription management Clubs on a **monthly subscription** (unlimited events up to a participant cap) manage billing from club settings. **Path:** Manager console → Club → **Subscription** ## What you see - Current plan tier (Pro or Pro+) - Monthly participant cap - Next billing date - Stripe subscription status ## Change participant cap Increase or decrease the subscribed participant count. Stripe prorates the difference on the next invoice. ## Upgrade plan tier Switch from **Pro** to **Pro+ Assisted** for included DistantRace setup support — billing updates via Stripe. ## Cancel or resume - **Cancel subscription** — ends monthly billing at the end of the current Stripe period (button on the Subscription page) - **Resume subscription** — if a subscription lapsed, use **Resume** on the Subscription page or the event **Upgrade** flow — [Upgrading participant limits](upgrading-participant-limits.md) Contact support@distantrace.com if you need help migrating from per-event upgrades to a club subscription. ## Invoices Stripe emails receipts for each monthly charge. One-time slot purchases use a separate flow — [Invoices for platform services](../finance-module/invoices-for-platform-services.md). ## Related - [Upgrading participant limits](upgrading-participant-limits.md) - [Costs and pricing](costs-and-pricing.md) --- # Club-wide join codes URL: /en/running-events/club-wide-join-codes/ # Club-wide join codes Besides per-event join codes ([Join codes and invitations](join-codes-and-invitations.md)), clubs can manage **club-level join codes** that grant access to private events. **Path:** Manager console → Club → **Join codes** ## Create a club join code 1. Join codes → **Create** 2. Set code string, usage limits, and expiry 3. Link to one or more events or leave club-wide for any private event in the club 4. Distribute via email — see [Email invitation links](../joining-events/email-invitation-links.md) ## Track usage The list shows how many times each code was used and by whom. Export for reporting. Use **Delete all unused** on the club join codes page to remove generated batches that were never redeemed — safe cleanup after an event sells out. ## Event-level codes Event-specific codes are configured under each event's settings and override or supplement club codes. Use event codes when only one race should be accessible. ## Related - [Join codes and invitations](join-codes-and-invitations.md) - [Using a join code](../joining-events/using-a-join-code.md) --- # CO₂, energy, and team challenges URL: /en/running-events/co2-energy-and-team-challenges/ # CO₂, energy, and team challenges The **create event wizard** includes challenge presets beyond standard run/bike/step types. They set default sports, leaderboard columns, and team rules you can adjust later. **Path:** Manager console → **Create event** → **Team**, **CO₂**, or **Energy** button Internal keys: `team_ch`, `co2_ch`, `energy_ch` — see [Create event wizard](create-event-wizard.md). ## Team challenge (`team_ch`) Team-first sports challenge — participants join **teams** and team standings are enabled from the start (`have_teams`, `have_teams_standings`). | Default | Value | |---------|--------| | Sports | Walk, hike, nordic walk, run, orienteering | | Teams | Required — team standings on | | Scoring | Distance per sport | | Access | Unlisted draft until you publish | ### Wizard team setup On the external Easy Event Create form you can choose: - **Organizer teams** (`Event Team = org`) — you enter comma-separated team names; participants pick from a required "Pick Team" question; only listed teams allowed (`only_private_teams`). - **Participant teams** (`Event Team = participant`) — participants create or join teams freely; same sport defaults apply. Configure team size caps and join rules later in [Challenge settings reference](challenge-settings-reference.md). Participant guide: [Joining a team](../joining-events/joining-a-team.md). ## CO₂ challenge (`co2_ch`) Tracks estimated **CO₂ savings** from active travel (walking, running, cycling) instead of driving. | Default | Value | |---------|--------| | Challenge kind | `CO2_CHALLENGE` | | Leaderboard columns | Rank, name, CO₂ total, CO₂ today | | Sports | Walk, hike, nordic walk, run, orienteering, ride | | Totals shown | Distance (other totals hidden vs standard challenges) | Ideal for sustainability campaigns. Participants see CO₂ totals on **My result** and the public leaderboard. ## Energy challenge (`energy_ch`) Scores participants on **energy** (calories converted to kWh) across all sport types. | Default | Value | |---------|--------| | Sport scoring | Calories per activity (`ChallengeSport.KIND.CALORIES`) | | Sports | All sport types enabled | | Energy unit | `kwh` in challenge params | | Totals | Distance, time, calories on result views | Use for wellness programs emphasizing active energy burn rather than distance alone. Leaderboard ordering follows total calories/energy unless you change display settings. ## Shared wizard defaults All three presets (and other wizard types) start with: - **Unlisted** access until you share the event - Registration open immediately through event end - GPS activities expected (`should_have_gps`) except step variants - 12-hour grace period after event end (`after_end_hours`) - Default hero image for the event type ## After creation 1. Adjust dates, access, and pricing in settings 2. For team events — review teams and the team picker question 3. Publish via [Share your event (Easy Access)](share-your-event-easy-access.md) 4. Monitor [Challenge dashboard analytics](challenge-dashboard-analytics.md) ## Related - [Event types overview](event-types-overview.md) - [Create event wizard](create-event-wizard.md) - [Combined challenges](combined-challenges.md) --- # Collecting interested participants URL: /en/running-events/collecting-interested-participants/ # Collecting interested participants The **Interested** list collects contact details from people who expressed interest in your club or events but have not registered yet. **Path:** Manager console → Club → **Interested** There is **no CSV export** on this page in the current manager — use the table filters and copy addresses manually, or route leads through [Marketing email export filters](marketing-email-export-filters.md) once they become registered participants. ## How entries are created Participants submit interest through: - Club page interest forms - Event preview pages with "Notify me" or similar CTAs - Challenge apply flow — email field before full registration - Marketing landing pages linked to your club - API or partner widgets that post an email against an event Exact forms depend on your public page configuration. ## Use the list The table shows: | Column | Meaning | |--------|---------| | **Email** | Contact address (click to mail) | | **Event** | Which event they expressed interest in | | **Applied** | Green check if they later completed registration | | **Created** | When the interest was submitted | ### Filters - **Search** — match email or event name - **Applied** — show only converted leads (`Applied = yes`) or only open leads (`Applied = no`) Entries with **Applied = no** are your pre-registration leads. The **Applied** flag updates automatically when the same email registers for that event (challenge apply, competition checkout, or API registration). ## Follow up | Audience | Tool | |----------|------| | Interested, not registered | Manual email from the table, or external CRM | | Registered participants | [Marketing email export filters](marketing-email-export-filters.md) or connected [Omnisend](../integrations/omnisend.md) / [Listmonk](../integrations/listmonk.md) | | Event-specific nudge | Filter Interested by event, then email before registration closes | Participant flow: [Registering interest before signup](../joining-events/registering-interest-before-signup.md). ## Privacy Only contact people according to the consent they gave when submitting interest. See [Marketing preferences on registration](marketing-preferences-on-registration.md). ## Related - [Marketing to participants](marketing-to-participants.md) - [Marketing email export filters](marketing-email-export-filters.md) --- # Combined challenges URL: /en/running-events/combined-challenges/ # Combined challenges **Combined challenges** score both **daily steps** and **sports workouts**, often with a [step game](step-game.md). They appear as a featured option in the create-event wizard. ## Create a combined challenge 1. **Create new Event** → Step 1: base data. 2. Step 2: under **Most popular**, select **Combined challenge**. 3. Create — a step game is created automatically with default tasks. ## Default scoring New combined challenges typically include scoring rules for: - Daily step threshold (for example 10,000 steps) - Step game task completion - Active day minimum (for example 30 minutes) Adjust rules in **Settings → Rules** and points in **Settings → Advanced** and [Step game](step-game.md). ## Walkthrough steps The walkthrough shows **Step game**, **Points**, and **Sports** sections in addition to standard steps. ## When to use Corporate wellness programs that want both walking and structured workouts, or events where different participants prefer steps vs runs. ## Participants Participants need the **mobile app** for steps and a **connected sports app** for workouts. Share the [challenge onboarding page](../joining-events/challenge-onboarding-page.md). --- # Competition advanced settings URL: /en/running-events/competition-advanced-settings/ # Competition advanced settings **Path:** Competition dashboard → Settings → **Advanced** Competition advanced settings are simpler than [challenge advanced settings](advanced-challenge-settings.md) — no scoring tiers or CO₂ fields. ## Show participant birth years **Field:** Show years on registration / public lists When enabled, birth year (or age group derived from it) is visible on start lists and public views. ::: warning Locked when registrations exist If participants already registered **without** age verification on the form, this toggle may be disabled to avoid inconsistent data. ::: When disabled, birth years are hidden from public views (`hide_year` in event params). ## Child subaccounts **Field:** Child subaccounts **Applies to:** Virtual competitions — **disabled for in-person ticket races**. Same workflow as challenges — parents register children and submit activities manually. See [Advanced challenge settings → Child subaccounts](advanced-challenge-settings.md#child-subaccounts). ## External signup URL Optional HTTPS link for white-label **paid registration** on an external site. Leave blank to use DistantRace checkout. ## Create linked virtual event (in-person races) **Button:** Create virtual event **Applies when:** In-person race is open and has no linked virtual event yet. Creates a companion **virtual competition** with: - Matching distances (virtual equivalents) - Free registration tickets - Shared branding Useful when in-person registrants should also submit GPS activities online (hybrid event). Creation runs in the background — check the competition list when complete. ## Related - [Competition settings reference](competition-settings-reference.md) - [Create an in-person race](create-an-in-person-race.md) - [Create a virtual competition](create-a-virtual-competition.md) --- # Competition club teams URL: /en/running-events/competition-club-teams/ # Competition club teams **Club teams** are teams defined at organization level that can be offered during **competition** registration. **Path:** Competition → Settings → **Club teams** ## Pick available teams 1. Select which club teams appear on the registration form 2. Optionally enable **Club teams only** — restricts choices to teams the participant belongs to at club level 3. Save ## Add a new club team Create a team inline from the same page if registration is still open. ## Difference from distance teams | Setting | Purpose | |---------|---------| | **Teams** (Settings → Teams) | Event-specific teams created for this competition | | **Club teams** | Reuse organization-wide teams (corporate leagues, running clubs) | ## Related - [Joining a team](../joining-events/joining-a-team.md) - [Partner and corporate registration](partner-and-corporate-registration.md) - [Competition settings reference](competition-settings-reference.md) --- # Competition dashboard analytics URL: /en/running-events/competition-dashboard-analytics/ # Competition dashboard analytics The **competition dashboard** is the first screen after opening a competition in the manager console. Besides shortcuts to settings and the start list, it shows live registration and revenue widgets. **Path:** Competition → dashboard (home tab) ## Per-distance summary A table breaks down each **distance** with: - Registered participant count - Ticket or registration **income** (paid carts only) - Refund totals where applicable Use this during registration windows to see which distances sell fastest. ## Registration and income charts Interactive charts plot **registrations** and **income** over time. Change the date range to focus on launch week, early-bird pricing, or race day. Charts load via AJAX — wait a moment after changing dates for data to refresh. ## Product sales If the competition sells **shop products** (merchandise, add-ons), the dashboard shows revenue per product. Cross-check with [Shop bought products list](shop-bought-products-list.md) for fulfillment. ## Dashboard exports From the competition home page you can queue: | Export | Content | |--------|---------| | **Export products** | Sold add-ons and merchandise for this competition | | **Export distance income** | Registration revenue broken down by distance | Files appear under [Organizer documents](../more-tools/organizer-documents.md). ## Premium packages When premium levels exist, the **competition dashboard** shows how many participants chose each tier — [Competition dashboard analytics](competition-dashboard-analytics.md). Configure tiers in [Premium registration packages](premium-registration-packages.md). ## Recent reviews The latest **participant reviews** (star rating + text) appear on the dashboard when reviews exist. Open [Participant event reviews](participant-event-reviews.md) for the full list and replies. ## Sports app connections For virtual competitions, a breakdown shows which sports apps registered participants use — helpful when debugging sync issues before results week. ## Related - [Managing tickets and pricing](managing-tickets-and-pricing.md) - [Managing orders and carts](managing-orders-and-carts.md) - [Club home dashboard](club-home-dashboard.md) --- # Competition distance sync mapping URL: /en/running-events/competition-distance-sync-mapping/ # Competition distance sync mapping When importing results from **timing files** or **URL sync**, external systems use their own distance identifiers. Map them to your DistantRace distances so finish times land on the correct category. **Path:** Competition → **Results → Import → Distance mapping** ## Add a mapping 1. Open distance mapping under Results → Import 2. Select your DistantRace **distance** (5K, marathon, etc.) 3. Enter the **external ID** or code from the timing export (see provider documentation) 4. Save Repeat for each distance in multi-distance races. ## Without mapping Unmapped external rows are skipped or placed in an import review queue. Always map before the first live sync on race day. ## Related - [Results URL sync](results-url-sync.md) - [Importing timing results](importing-timing-results.md) --- # Competition settings reference URL: /en/running-events/competition-settings-reference/ # Competition settings reference Open **Settings** from a competition dashboard. Virtual and in-person races share most sections; some differ by competition kind. ## Base settings **Path:** Settings → **Competition** | Field | Description | |-------|-------------| | Start / End | Event window in club timezone | | Status | Published, unpublished, cancelled | | Access | Public, club, unlisted, private | | Join password | Shared password when private | | Embed URLs | iframe links for results, start list, registration widget (requires [verified domains](embed-domains-for-iframes.md)) | ## Event Customization **Path:** Settings → **Event Customization** Per-language name, description, images, and SEO slugs — same pattern as challenges. ## Distances Define race distances (5K, marathon, etc.), caps, and team eligibility per distance. In-person races link distances to [tickets](managing-tickets-and-pricing.md). ## Sports *(virtual competitions)* Accepted GPS sports and primary sport type — [Competition sports settings](competition-sports-settings.md). Minimum distance per submission and validation rules: [Reviewing virtual workouts](reviewing-virtual-workouts.md). ## Teams **Path:** Settings → **Teams** Enable team registration; participant-created vs organizer-defined teams. ## Club teams *(in-person)* **Path:** Settings → **Club teams** Pick which **club-level teams** appear at registration. Option to restrict to club members' private teams only. See [Competition club teams](competition-club-teams.md). ## Per-distance teams Assign team categories to specific distances (relay teams, corporate cups). ## Groups Age/gender groups per distance for standings and start lists. See [Age groups and standings groups](age-groups-and-standings-groups.md). ## Pages Info pages, mandatory regulations with consent checkbox, after-registration content. See [Event info pages and regulations](event-info-pages-and-regulations.md). ## Questions Custom registration fields on the apply form. See [Registration form questions](registration-form-questions.md). ## Registration Registration window, birth year limits, online payment end date, race-day registration toggle. See [Race-day registration and check-in](race-day-registration-and-check-in.md). ## Join codes Per-competition invitation codes — [Join codes and invitations](join-codes-and-invitations.md). ## Advanced Birth year visibility, child subaccounts, external signup URL, create linked virtual event. See [Competition advanced settings](competition-advanced-settings.md). ## Danger zone Permanently remove the competition from the club. See [Event danger zone](event-danger-zone.md). ## Operations (outside Settings menu) | Area | Guide | |------|-------| | Start list | [Managing the start list](managing-the-start-list.md) | | Bib numbers | [Bib number management](bib-number-management.md) | | Orders | [Managing orders and carts](managing-orders-and-carts.md) | | Reserved entries | [Reserved entries](reserved-entries.md) | | Results | [Results](../results/index.md) | | Standings | [Standings and rankings](../results/standings-and-rankings.md) | | Shipping | [Managing Omniva shipments](managing-omniva-shipments.md) | | Reviews | [Participant event reviews](participant-event-reviews.md) | | History | [Event history and audit log](event-history-and-audit-log.md) | --- # Competition sports settings URL: /en/running-events/competition-sports-settings/ # Competition sports settings Virtual and timed competitions accept only workouts in **allowed sport types**. Configure the list before participants start submitting GPS activities. **Path:** Competition → Settings → **Sports** ## Main sport Set the **primary sport** for the event (for example Running). This controls the sport icon on competition pages and the default category in results — it does **not** by itself restrict which workouts count. Use the dropdown at the top of the page and click **Save**. ## Accepted sports list (virtual races only) For **virtual timed competitions**, drag sports between **All Sports** and **Accepted Sports in the Competition**: - Only activities recorded as an **accepted sport** can count toward the virtual result - Participants recording the wrong sport type in their app see the activity rejected — see [Why activities are missing](../joining-events/why-activities-are-missing.md) In-person races show main sport only; the drag-and-drop lists appear when `is_virtual_race` is enabled. Click **Save** (`action=update_sports`) to persist both main sport and accepted list. ## Locked after the event ends When the competition is no longer **open**, the form is disabled and saving shows a warning that changes cannot be made after the end of the competition. ::: warning Existing results are not recalculated Changing accepted sports after participants have already synced workouts does **not** automatically re-validate past activities. Update sports before the event starts, or review workouts manually under [Reviewing virtual workouts](reviewing-virtual-workouts.md). ::: ## When to adjust - Multi-sport virtual festival (run + walk + hike) - Restrict to cycling only on a bike virtual race - Remove sports that cause false positives from auto-sync ## Validation flow 1. Participant syncs a workout 2. DistantRace checks sport type against this list 3. Valid rows appear under **Workouts** — [Reviewing virtual workouts](reviewing-virtual-workouts.md) 4. Participant may [select a workout](../joining-events/selecting-your-virtual-race-workout.md) if multiple activities qualify ## Challenge sports (different page) Sports **challenges** use a richer editor (points per km, aliases, result columns) at Settings → Sports on the challenge — [Challenge settings reference](challenge-settings-reference.md). ## Related - [Competition settings reference](competition-settings-reference.md) - [Create a virtual competition](create-a-virtual-competition.md) - [Virtual competition sport variants](virtual-competition-sport-variants.md) --- # Copying a challenge URL: /en/running-events/copying-a-challenge/ # Copying a challenge Reuse a successful challenge setup by **copying** it from the challenge dashboard instead of creating from scratch. **Path:** Challenge dashboard → **Copy** (modal form) ## What you can copy The copy dialog lets you choose what carries over to the new challenge, typically including: - Basic settings and dates (adjusted on save) - Sports activity types - Registration questions - Images and branding - Team configuration - Step game tasks (when enabled) Uncheck sections you want to rebuild manually. ## New challenge identity The copy creates a **new unpublished challenge** with a fresh event code. Update name, dates, and public URL before publishing. ## Participants Participant copy is **not** available to regular organizers — only platform superusers can optionally include participants when copying (for internal migrations). ## After copying 1. Open the new challenge dashboard 2. Walk through [Challenge settings walkthrough](challenge-settings-walkthrough.md) 3. Publish when ready — [Share your event (Easy Access)](share-your-event-easy-access.md) ## Competitions There is no identical one-click copy on competitions — use [Create event wizard](create-event-wizard.md) or create a new competition and mirror settings manually. ## Related - [Create a step challenge](create-a-step-challenge.md) - [Event history and audit log](event-history-and-audit-log.md) --- # How are costs formed? URL: /en/running-events/costs-and-pricing/ # How are costs formed? ##### If you want to organize challenges and competitions paid for by the organizer DistantRace offers 2 price categories and 2 different approaches. 1. **"Pro"** - 1 euro per participant per month in one challenge 2. **"Pro+ Assisted"** - 3 euros per participant per month in one challenge The "Pro" level includes the use of the system and full functionality, while "Pro+ Assisted" also includes DistantRace support in event configuration. If you choose the "Pro" level, then the organizer must create and configure the event themselves, and DistantRace team support will be available in cases of system errors or *bugs*. On the other hand, "Pro+ Assisted" offers consultations with DistantRace, as well as priority in problem-solving. ![](/static/img/introduction-to-organizing-competitions/how-are-costs-formed/image-1712582518740-21-47.png) If you wish to organize multiple events over several months, then there is an option to subscribe to DistantRace services. The subscription period has a minimum of 1 year, during which the organizer can create an unlimited number of different events with the subscribed number of participants. For example, if you know that the maximum number of participants that can join is 200, then by subscribing to the "Pro" level and paying 200 euros per month for the whole year, you can create an unlimited number of sports competitions and challenges each month, where each event can have up to 200 participants. ##### If you want to create sports events where the participant pays for their own participation If you want to create such sports events, then we charge 3% of the transaction (minimum 40 cents per transaction) + keep in mind that the bank also takes up to 2% for the transfer. It is possible to include our commission in the participation fee or to list it as an additional payment. Read information about the options for [integrating with payment systems](../finance-module/integrations-with-payment-systems.md). --- # How to Create a Club URL: /en/running-events/create-a-club/ # How to Create a Club To create events, the first task is to create your own club. A club does not always have to be perceived as a "club"; it can be the name of the organizer, the name of a company, or simply the first and last name of someone who wants to create events. For example, if a company wants to create sports events for its employees, then it can be the name of the company. Or, if friends want to engage in sports together, then it could be, for example, "The Friendly Club". Be creative! ![](/static/img/introduction-to-organizing-competitions/how-to-create-a-club/image-1712177328905-48-36.png) --- # Create a sports activity challenge URL: /en/running-events/create-a-sports-activity-challenge/ # Create a sports activity challenge Sports activity challenges count **workouts** from connected sports apps over a multi-day window. ## Create the event 1. Open your club in the manager console. 2. Click **Create new Event**. 3. **Step 1 — Base data:** name, start date, duration in days, main language. 4. **Step 2 — Challenge type:** under **Sport-specific challenges**, choose: - **Running challenge** — run, walk, hike, orienteering - **Cycling challenge** — ride distance - **Active days challenge** — days meeting minimum active time 5. Click **Create**. You are redirected to the [challenge settings walkthrough](challenge-settings-walkthrough.md). ## Configure essentials | Setting | What to do | |---------|------------| | Sports | Confirm accepted sports and points per km | | Rules | Set GPS rules, sync window, daily limits | | Teams | Enable if needed | | Registration | Set dates and age limits | | Easy Access | Share link and QR with participants | ## Related challenge types - [Combined challenges](combined-challenges.md) — steps plus workouts - [Points challenges](points-challenges.md) — flexible points per km - [Create a step challenge](create-a-step-challenge.md) — daily steps only ## Participant guide Share [Participate in a challenge](../joining-events/participate-in-a-challenge.md) with your participants. --- # Create a step challenge URL: /en/running-events/create-a-step-challenge/ # Create a step challenge ## Create the event 1. Open your club in the manager console. 2. Click **Create new Event**. 3. **Step 1 — Base data:** event name, start date, duration in days, main language. 4. **Step 2 — Challenge type:** select **Step challenge** (featured bestseller option). 5. Click **Create**. You are redirected to the [challenge settings walkthrough](challenge-settings-walkthrough.md). A default [step game](step-game.md) is created automatically. ::: tip Participant app required Step challenges need the DistantRace mobile app for daily step sync. Share the [onboarding page](../joining-events/challenge-onboarding-page.md). ::: ## Configure during walkthrough Complete dates, languages, teams, virtual map, goals, and Easy Access sharing. See [Challenge settings reference](challenge-settings-reference.md) for every option. The sections below document individual settings in detail (teams, virtual route, stages, payments, etc.). --- ## Detailed settings #### Virtual Route To make the challenge more interesting, you can choose a virtual route that participants can follow. Such a route makes the challenge more interesting and engaging for participants. ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712216505715-41-38.png) ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712216416345-39-57.png) ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712577090919-51-20.png) You can also specify the name of the start place and the end place in the virtual route. #### Teams In the challenge, it is possible to create teams. Results will be shown both individually and by teams. There are 2 types of teams: - Participants create their own teams. - The organizer predetermines the teams. In case the teams are company departments or divisions or branches, then the organizer should prepare them. On the other hand, if you want teams to be created by the participants themselves, then this is also possible. If it is expected that each team will have a different number of participants, you can define how many of the team's participants will be included. For example, if team A has 50 participants, but team B has 20 participants and it is indicated that only 20 participants will be included in the team, then only the 20 participants with the best results will be considered in both teams. It is also possible to place the participants in teams in a "random" way after applying. To do this, contact support@distantrace.com. ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712218003107-03-11.png) ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712218014088-03-15.png) #### Change Event Information In the challenge settings, you can change both the start time and the end date and time. In addition, you can mark the status of the event: - Published - Published and available. - Unpublished - Not published. This can be used if the created event needs to be removed so that it is no longer available. - Cancelled - If the event is cancelled, we can set this status. In addition to this, you can define who the event is visible to. DistantRace has several levels: - Public - Found on the homepage for any visitor. This status can only be set by a DistantRace consultant. - Show for club members - Events are visible to those participants who are your club members. - Unlisted - The event is only available if you know the private link. - Private - You can only join the event if you know the private link + you also need to know the joining password. ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712232036404-53-58.png) To change the name, add an image and add a description, go to the section "Event Customization". In this section, you can add the name and description of the created event in different languages. ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712232106178-00-58.png) #### Stages of the Sports Event If we want to create a step challenge for the whole summer, but each month we want to see a winner, then we can create "Intermediate Results". You can find this in the "Stages" section. ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712232197357-03-11.png) ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712300233957-57-03.png) When the stages are added, they can be seen in the results list. Stage results will also appear for the teams. ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712300338260-58-20.png) #### Age Groups To make it more interesting for participants to compete among themselves, you can add age groups. Then it will be possible to view not only the total results, but also by age groups. Groups can be defined in the "Groups" section. ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712300598060-01-41.png) The challenge organizer defines age groups once, and they can be reused in other challenges. It's possible to specify not only birth years but also the gender, if needed. ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712300756429-05-45.png) Once all age groups are added, they can be viewed in a simple way. ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712300898541-07-38.png) #### Additional Information Pages Each sports event can have additional informational pages added, for example, rules. If rules are added, the participant will need to agree to the rules when joining the event. The pages have 3 types: - Regular page - A standard informational page that can be viewed next to the "results" and other sections. - After-apply page - Informational page that appears after registration for the challenge - Regulation - The text of the rules that appears similar to the "Regular page", but additionally, the participant must agree to the rules before they can register for the challenge. ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712576546666-41-22.png) #### Additional Questions If you want the participant to answer additional questions when registering, then you can add such questions. Both order and obligation to answer can be defined for each question. Question types: - Text - Text field - Choice - Selection field - Yes/No - Choose Yes/No - Number - Numerical field If a selection field is chosen, then all possible values that the participant can choose from must be specified. ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712576925637-48-39.png) #### Registration Restrictions You can specify when registration is possible and when it should end, as well as the minimum/maximum birth year for who can register for the sports event. ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712576962035-49-14.png) #### Objectives It is possible to define achievable step objectives in 3 categories: - Individual - Cumulative for everyone together - For each team ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712577815528-01-56.png) ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712577824418-02-37.png) ![](/static/img/daily-step-challenges/how-to-create-a-step-challenge/image-1712577830036-02-41.png) --- # Create a virtual competition URL: /en/running-events/create-a-virtual-competition/ # Create a virtual competition Virtual competitions are **timed efforts over a fixed distance** — participants record one GPS workout. ## Create the event 1. **Create new Event** → base data. 2. Step 2: under **Virtual competitions**, choose **Virtual Run 5k** or **Virtual Bike 20k** (or another virtual type when available). 3. Create — you land on **Easy Access** to share the event. Default setup includes a published distance (5 km or 20 km) and a free ticket. ## Configure | Area | Path | |------|------| | Distances | Settings → Distances — length, splits | | Sports | Settings → Sports — main and secondary sports | | Registration | Settings → Registration — dates, age limits | | Teams | Settings → Teams — per distance if needed | | Questions | Settings → Questions — custom fields | | Join codes | Settings → Join Passwords | | Results embed | Settings → Base — iframe URLs | ## Manage during the event - **Start list** — registered participants - **Workouts** — review synced GPS activities - **Results** — times and placements See [Reviewing virtual workouts](reviewing-virtual-workouts.md) and [Managing the start list](managing-the-start-list.md). ## Participants [Participate in virtual competitions](../joining-events/participate-in-virtual-competitions.md) ## Linked in-person virtual event In-person races can spawn a **linked virtual event** from advanced competition settings for remote participants. --- # Create an in-person race URL: /en/running-events/create-an-in-person-race/ # Create an in-person race In-person races use **tickets** (distances), **online payment**, **start lists**, and optional **race-day registration**. ## Create the event 1. In the manager console, create a new **competition** (in-person type) with name, dates, and language. 2. Configure **distances** — each distance can have its own length, teams, and results. 3. Set up **tickets** and pricing in the finance/shop module. 4. Configure **registration** questions and age limits. ## Essential settings | Setting | Purpose | |---------|---------| | Distances | Race lengths, team distances, checkpoints | | Tickets | Prices, early bird, race-day fees | | Registration | Online window, [race-day QR registration](race-day-registration-and-check-in.md) | | Questions | Custom participant fields | | Banking | Required for paid events — [Club settings](club-settings-and-admins.md) | ## Finance and shop - [Finance module](../finance-module/introduction-to-the-finance-module.md) - [Discount codes](../finance-module/discount-codes.md) - [Upsell products](upsell-products-in-checkout.md) ## Race operations - [Managing the start list](managing-the-start-list.md) - [Bib number management](bib-number-management.md) - [Importing timing results](importing-timing-results.md) - [Checkpoint passages](checkpoint-passages.md) ## Participants [Register for in-person competitions](../joining-events/register-for-in-person-competitions.md) ## Partner registration [Partner and corporate registration](partner-and-corporate-registration.md) — reserved entries and discount links. --- # Create event wizard URL: /en/running-events/create-event-wizard/ # Create event wizard **Path:** Manager console → **Create event** (or club home → create) The wizard creates a draft event with sensible defaults (unlisted access, registration open now, you are added as the first participant) and redirects to the overview or Easy Access flow. ## Choose event type Challenge and competition buttons map to internal `event_type` keys used by `EventCreateMixin`: | Button | Key | Result | |--------|-----|--------| | Step challenge | `walk_ch` | Daily steps challenge — [Create a step challenge](create-a-step-challenge.md) | | Running challenge | `run_ch` | Run + walk sports — [Sports activity challenge](create-a-sports-activity-challenge.md) | | Cycling challenge | `bike_ch` | Ride-only sports | | Active days | `active_ch` | Time-based move challenge | | **Team challenge** | `team_ch` | Team standings on by default — [CO₂, energy, and team challenges](co2-energy-and-team-challenges.md) | | **CO₂ challenge** | `co2_ch` | CO₂ savings leaderboard | | **Energy challenge** | `energy_ch` | Calorie → kWh scoring | | Points | `points_ch` | Custom distance points — [Points challenges](points-challenges.md) | | Combined | `combined_ch` | Steps + sports + step game — [Combined challenges](combined-challenges.md) | | Virtual run | `run_com` | GPS timed race — [Virtual competition](create-a-virtual-competition.md) | | Virtual bike | `bike_com` | Virtual cycling competition | | Paddle / ski | `paddle_com`, `ski_com` | Other virtual sport presets | | In-person race | ticket flow | Real-world event — [Create an in-person race](create-an-in-person-race.md) | See [Event types overview](event-types-overview.md) for participant-facing differences. ## Team options (external create flow) The public **Easy Event Create** form (marketing landing wizard) adds optional team setup for `team_ch` and competitions: | **Event Team** value | Behavior | |---------------------|----------| | `org` | Organizer-defined teams only (`only_private_teams`); comma-separated **Team Names** pre-created; required "Pick Team" registration question | | `participant` | Participants can create/join teams; team standings enabled on distances (competitions) or challenge (`have_teams`) | Console **Create event** uses the same presets but team names are configured afterward under challenge/competition team settings. ## Copy from template Duplicate an existing club event as a starting point — settings, distances, and pages copy over; dates and registrations reset. Some DistantRace template challenges can be copied from the global library when `allow_copy` is enabled. ## After creation | Event kind | Next step | |------------|-----------| | Challenge | [Challenge settings walkthrough](challenge-settings-walkthrough.md) or overview (`?new=1`) | | Competition | [Easy Access](share-your-event-easy-access.md) or competition settings | Special presets (CO₂, energy, team) — see [CO₂, energy, and team challenges](co2-energy-and-team-challenges.md). ## Related - [Create a club](create-a-club.md) - [Access the organizer console](access-the-organizer-console.md) - [CO₂, energy, and team challenges](co2-energy-and-team-challenges.md) --- # Customizing results tables URL: /en/running-events/customizing-results-tables/ # Customizing results tables **Settings → Display of results** controls public leaderboard columns. ## Participant table Toggle columns such as rank, name, country, team, time, distance, steps, points, CO₂, map progress, and daily step fields (step challenges). ## Team table When teams are enabled, configure parallel columns for team standings. ## Per-sport columns For sports challenges, show or hide statistics for each accepted sport. ## Effect Changes apply to the public **Results** tab and embedded result iframes. ## Related - [Embedding results on your website](embedding-results-on-your-website.md) --- # Editing individual challenge participants URL: /en/running-events/editing-individual-challenge-participants/ # Editing individual challenge participants Open a participant's **challenger detail** page for per-person support and corrections. **Path:** Challenge → Participants → click a name ## Participant overview Shows totals, team, distance, daily breakdown (step challenges), sport columns, and activity history. ## Add manual data | Challenge type | Action | |----------------|--------| | Step | **Add daily steps** — pick date and step count within challenge window | | Sports / combined | **Add activity** — manual workout form linked to participant | Manual entries are logged as organizer-added and trigger result recalculation. ## Delete all results **Delete All Results** (danger zone on the challenger detail page) clears every activity the participant has submitted to this challenge. The participant **stays enrolled** and can sync or add new workouts afterward. **Path:** Challenge → Participants → open a name → scroll to **Delete All Results** → confirm in the modal What happens: 1. All non-removed activities are marked **removed by organizer** 2. Challenge and team standings are recalculated 3. An audit log entry is written on the participant profile 4. **Geo challenges** also clear map segment progress and recalculate geo totals Use this for cheating investigations, bad imports, or when a participant asks for a full reset. It does **not** withdraw the person from the event — use **Remove participant** for that. Individual accept/reject for single workouts is on the **Workouts** tab — see [Managing challenge participants](managing-challenge-participants.md). ## Change team Update team assignment from the detail page. Team totals recalculate for old and new teams. ## Remove participant Permanently removes the challenger from the event (not reversible from UI). Logged in event history. ## Export step sync times Step challenges only — queue an export of when the participant's device synced each day. File appears under [Organizer documents](../more-tools/organizer-documents.md). ## Comments Add internal organizer comments on the participant profile (visible to club staff, not the participant). ## Related - [Managing challenge participants](managing-challenge-participants.md) - [Advanced challenge settings](advanced-challenge-settings.md) — manual workouts toggle - [Why activities are missing](../joining-events/why-activities-are-missing.md) --- # Embed domains for iframes URL: /en/running-events/embed-domains-for-iframes/ # Embed domains for iframes Before embedding DistantRace results or registration widgets on your website — or hosting a **whitelabel participant portal** on your own domain — add and **verify** each domain at the club level. **Path:** Manager console → Club → **Embed domains** ## Add a domain 1. Enter the domain (e.g. `www.myrace.lv`) — no `https://` prefix 2. Save — DistantRace shows a **DNS TXT record** to add at your DNS provider 3. Click **Verify** after the TXT record propagates (may take up to an hour) Verified domains appear with a green status. Only verified domains can embed iframes. ## Disable without deleting Use **Toggle active** to temporarily block embedding from a verified domain without removing DNS verification. Re-enable when ready. ## Per-event embedding After domains are verified, copy embed URLs from: - Challenge → Settings → [Iframe embedding](embedding-results-on-your-website.md) - Competition → Settings → Base (results, start list, registration widget) Event-level settings inherit club-level domain allowlists. ## Troubleshooting | Issue | Fix | |-------|-----| | Embed shows blank / blocked | Domain not verified or typo in domain name | | Verification fails | Confirm TXT record at root or `_distantrace` host per instructions | | Works on www but not apex | Add both `example.com` and `www.example.com` | ## Whitelabel custom domains Verified embed domains also authorize your club's branded participant portal and themed login flows. DistantRace maps the domain to your organization for CORS, OAuth return URLs, and login-page branding. Full overview: [Whitelabel and enterprise setup](whitelabel-and-enterprise-setup.md). ## Related - [Whitelabel and enterprise setup](whitelabel-and-enterprise-setup.md) - [Embedding results on your website](embedding-results-on-your-website.md) - [Introduction to integrations](../integrations/introduction-to-integrations.md) --- # Embedding results on your website URL: /en/running-events/embedding-results-on-your-website/ # Embedding results on your website Display DistantRace results on your club or event website using **iframe embeds**. ## Challenge embedding **Settings → Iframe embedding** - Add allowed **domains** that may embed your results - Copy embed URLs for participant results, team results, or other views ## Competition embedding **Settings → Base** on competitions includes embed URLs for: - Results - Team results - Start list - Standings - Registration widget ## Org-level domains Configure default allowed embed domains at club level — see [Embed domains for iframes](embed-domains-for-iframes.md). ## Security Only listed domains can embed; others are blocked by the browser frame policy. ## Related - [Customizing results tables](customizing-results-tables.md) --- # Event danger zone URL: /en/running-events/event-danger-zone/ # Event danger zone **Path:** Event dashboard → Settings → **Danger zone** ::: danger Permanent action Deleting an event sets status to **Removed** and hides it from the manager console and public site. This cannot be undone from the UI. ::: ## Delete event 1. Open Settings → Danger zone 2. Confirm deletion 3. You are redirected to the club home — the event no longer appears in event lists Deletion is logged in [event history](event-history-and-audit-log.md). ## Before deleting - Export participants and results you may need — [How to export data](../more-tools/how-to-export-data-from-distantrace.md) - Process pending [orders](managing-orders-and-carts.md) and refunds - Inform participants if the event was published ## Cancel vs delete Setting status to **Cancelled** on base settings keeps the event visible to organizers but closed to new registrations. Danger zone **delete** removes the event entirely. ## Related - [Challenge settings reference](challenge-settings-reference.md) - [Competition settings reference](competition-settings-reference.md) --- # Event history and audit log URL: /en/running-events/event-history-and-audit-log/ # Event history and audit log Every significant change to a competition or challenge is logged in **Event history**. **Path:** Open event → **History** ## What is logged - Settings changes (registration dates, distances, tickets) - Participant additions and edits - Bib number assignments - Result imports and manual edits - Ticket and price changes Each entry shows timestamp, user, and action description. ## Filter Filter by date range or action type to investigate a specific change (e.g. who imported results or changed a ticket price). ## Related - [Managing the start list](managing-the-start-list.md) - [Importing timing results](importing-timing-results.md) --- # Event info pages and regulations URL: /en/running-events/event-info-pages-and-regulations/ # Event info pages and regulations Add rich-text **pages** to your event — course info, FAQs, sponsor content, mandatory regulations, and a thank-you page after registration. **Path (challenge):** Challenge → Settings → **Pages** **Path (competition):** Competition → Settings → **Pages** ## Page types | Kind | Purpose | |------|---------| | **Regular page** | General info linked from the event menu (unlimited per language) | | **Regulation** | Mandatory rules — participant must accept during registration (one per language) | | **After-apply page** | Shown immediately after successful registration (one per language) | ## Page fields | Field | Notes | |-------|-------| | **Title** | Becomes the page URL slug | | **Language** | Leave empty to inherit the event default language | | **Status** | Published pages are visible; unpublished are draft | | **Content** | Rich text with images — sanitized HTML | | **Can access** *(private events only)* | Allow access without joining when checked | Only **one regulation** and **one after-apply page** per language are allowed. ## Regulations and consent When a regulation page is published, registration shows a **consent checkbox**. Participants cannot complete signup without accepting. Participant experience: [Event regulations and consent](../joining-events/event-regulations-and-consent.md). ## Private events For unlisted or private challenges, mark regular pages as **Can access** so invited participants can read info before they have a join code. ## Related - [Registration form questions](registration-form-questions.md) - [Event translations and localization](event-translations-and-localization.md) - [Share your event (Easy Access)](share-your-event-easy-access.md) --- # Event internal comments URL: /en/running-events/event-internal-comments/ # Event internal comments Organizers can leave **internal comments** on event dashboards — visible only to club staff in the manager console, not to participants. **Path:** Competition or challenge **dashboard** → comments section ## Purpose Use comments for handover notes between race directors: - "Bib pickup moved to tent B" - "Waiting for timing company file" - "Refund pending for entry #142" Comments are timestamped and attributed to the staff member who wrote them. ## Add a comment Type in the comment field on the dashboard and submit. Recent comments appear in the dashboard sidebar or comments block. ## Delete a comment Staff can remove outdated comments with the delete action next to each entry. ## Audit trail Major event changes also appear in [Event history and audit log](event-history-and-audit-log.md). Comments are informal; the audit log records structural edits (settings, payments, status). ## Related - [Club home dashboard](club-home-dashboard.md) - [Access the organizer console](access-the-organizer-console.md) --- # Event translations and localization URL: /en/running-events/event-translations-and-localization/ # Event translations and localization Run multilingual events by adding a **language version** for each supported locale. **Path (challenge):** Challenge → Settings → **Event Customization** **Path (competition):** Competition → Settings → **Event Customization** ## What each translation contains | Field | Purpose | |-------|---------| | **Language** | Locale code (e.g. `lv`, `en`, `de`) | | **Event name** | Title on the public page in that language | | **Description** | Rich-text intro on the event home page | | **Main goal** | Short tagline under the title | | **Place name** | Venue or location label | | **Front / large image / logo** | Optional per-language branding assets | The primary language is created when you first save the event. Add more until you reach the platform language limit. ## Add a language 1. Open **Event Customization** in settings 2. Click **Add** and pick a language not yet used 3. Fill in name and description — images are optional (defaults fall back to the primary version) 4. Save ## Delete a translation Remove a non-primary language version from the translation editor. You cannot delete the last remaining version. ## Pages and questions per language - [Info pages and regulations](event-info-pages-and-regulations.md) can be authored per language - [Registration questions](registration-form-questions.md) should be translated manually for each locale you support ## Public URLs Each language version gets its own public URL. Share language-specific links from [Easy Access](share-your-event-easy-access.md) and the [challenge onboarding page](../joining-events/challenge-onboarding-page.md). ## Related - [Challenge settings walkthrough](challenge-settings-walkthrough.md) — Languages step - [Club branding and hero images](club-branding-and-hero-images.md) --- # Event types overview URL: /en/running-events/event-types-overview/ # Event types overview When you create an event in the DistantRace manager console, you choose a type. Each type has different settings and participant flows. ## Step challenges Participants compete on **daily steps** synced from phone or watch. Best for corporate wellness and simple team events. - Create: [Create a step challenge](create-a-step-challenge.md) - Participants: [Participate in a challenge](../joining-events/participate-in-a-challenge.md) ## Sports activity challenges Participants record **workouts** in sports apps (run, bike, active time, etc.). Distance, time, or active days accumulate over the event window. Types in the create wizard: | Type | Scoring focus | |------|----------------| | Running challenge | Run, walk, hike, orienteering distance | | Cycling challenge | Ride distance | | Active days challenge | Days meeting minimum activity time | | Team challenge | Team standings across walk/run sports | | CO₂ challenge | Estimated carbon savings from active travel | | Energy challenge | Calories scored as kWh | | Points challenge | Points per km across sports | | Combined challenge | Steps + workouts + step game | - Create: [Create a sports activity challenge](create-a-sports-activity-challenge.md), [Combined challenges](combined-challenges.md), [Points challenges](points-challenges.md), [CO₂, energy, and team challenges](co2-energy-and-team-challenges.md) ## Virtual competitions Timed races over a **fixed distance** (for example 5 km run or 20 km bike). One GPS workout determines the result. Wizard presets: run, bike, paddle/row, ski — [Virtual competition sport variants](virtual-competition-sport-variants.md). - Create: [Create a virtual competition](create-a-virtual-competition.md) - Participants: [Participate in virtual competitions](../joining-events/participate-in-virtual-competitions.md) ## In-person races Ticket-based registration, payments, start lists, bib numbers, and timing integration for physical events. - Create: [Create an in-person race](create-an-in-person-race.md) - Participants: [Register for in-person competitions](../joining-events/register-for-in-person-competitions.md) ## After creating any event 1. Complete the [challenge settings walkthrough](challenge-settings-walkthrough.md) (challenges) or competition settings 2. Share via [Easy Access](share-your-event-easy-access.md) 3. Manage participants and results as the event runs --- # Exporting challenge data URL: /en/running-events/exporting-challenge-data/ # Exporting challenge data Challenge dashboards offer several **XLSX exports** for reporting and audits. All exports queue as [organizer documents](../more-tools/organizer-documents.md) — refresh the Documents list to download. ## Participant list export **Path:** Challenge → **Participants** → **Export XLSX** (participant export) Includes enrolled challengers with totals, team, distance, contact fields where available, sport-specific columns (distance, time, calories, active days, points), and **one column per custom registration question** from [Registration form questions](registration-form-questions.md). Use for: - Final results backup - HR or wellness reporting - Mailing lists combined with [marketing export filters](marketing-email-export-filters.md) when you need club-wide filters instead ## Step data export **Path:** Challenge → **Participants** → **Export step data** *(step challenges only)* Spreadsheet of per-participant step summaries for the challenge window — complementary to the per-day breakdown in [Exporting step challenge daily results](exporting-step-challenge-daily-results.md). ## Team standings export **Path:** Challenge → **Teams** → **Export XLSX** Team-level totals and member contribution columns (respects **Top results in team** limits from [Advanced challenge settings](advanced-challenge-settings.md)). ## Daily step rows (all participants) **Path:** Challenge → **Workouts** → **Export XLSX** One row per participant per day — see [Exporting step challenge daily results](exporting-step-challenge-daily-results.md). ## Per-participant sync audit **Path:** Challenge → Participants → open a name → **Export step sync times** Device sync timestamps for one person — [Editing individual challenge participants](editing-individual-challenge-participants.md). ## Privacy Exports contain personal data. Store files securely and follow GDPR/marketing consent rules. Access is logged in the event audit trail. ## Related - [Managing challenge participants](managing-challenge-participants.md) - [Managing challenge team standings](managing-challenge-team-standings.md) - [How to export data from DistantRace](../more-tools/how-to-export-data-from-distantrace.md) --- # Exporting step challenge daily results URL: /en/running-events/exporting-step-challenge-daily-results/ # Exporting step challenge daily results For **step challenges**, export every participant's daily step entries in one spreadsheet — useful for audits, wellness reports, and dispute resolution. **Path:** Challenge → **Workouts** → **Export XLSX** The button appears only on step challenges (not sports activity challenges). ## What the export contains Each row is one daily step entry: | Column | Content | |--------|---------| | **Date** | Calendar day | | **Participant** | Full name | | **Steps** | Step count credited that day | | **Distance (km)** | Converted distance from step length | | **Status** | Accepted, pending, or removed | ## How to download 1. Open the challenge **Workouts** tab 2. Click **Export XLSX** 3. DistantRace queues the file as an [organizer document](../more-tools/organizer-documents.md) 4. Download the XLSX when processing completes (usually within a minute) Large challenges may take longer — refresh the Documents list. ## Per-participant sync audit To inspect **when** a single participant's phone synced steps (device timestamps, sync delays), use **Export step sync times** on their [participant detail page](editing-individual-challenge-participants.md). ## Related - [Managing challenge participants](managing-challenge-participants.md) - [Step game](step-game.md) - [Challenge dashboard analytics](challenge-dashboard-analytics.md) --- # Geo location restrictions URL: /en/running-events/geo-location-restrictions/ # Geo location restrictions Sports challenges can require activities to occur inside (or outside) defined **map areas**. **Path:** Settings → Location of workouts ## Create areas Draw **allowed** or **forbidden** polygons or lines on the map. Give each area a title. ## Effect on results Workouts outside allowed regions (or inside forbidden ones) are rejected by challenge rules. Participants see the reason on their activity detail. ## Use cases - Company campus step/workout events - City-limited charity runs - Excluding treadmill segments when outdoor GPS is required ## Related - [Challenge rules and activity limits](challenge-rules-and-activity-limits.md) --- # Importing the start list from a spreadsheet URL: /en/running-events/importing-start-list-from-spreadsheet/ # Importing the start list from a spreadsheet Instead of assigning bib numbers one by one, upload an **Excel (.xlsx)** file to update the competition start list in bulk. **Path:** Competition → **Start list** → import/upload control ## When to use - Timing company sends a bib assignment spreadsheet - You exported the start list, edited numbers offline, and need to re-import - Race-day batch registration produced a list of names and bib numbers This import updates **bib numbers and participant matching** — it is not the same as [importing timing results](../results/managing-race-results.md) or the [CSV importer](../more-tools/csv-importer.md). ## File requirements - Format: **`.xlsx`** (Excel Open XML) - Use the column layout expected by DistantRace (match a recent **export** from the same start list when unsure) ::: warning Processing is asynchronous After upload, processing runs in the background. Refresh the start list after a minute. You receive a success message when the file is queued. ::: ## After import 1. Spot-check a few entries for correct bib numbers 2. Resolve duplicates via [Merge](../more-tools/merging-duplicate-participants.md) if the file created overlaps 3. Export again for your timing partner if needed — see [Managing the start list](managing-the-start-list.md) ## Related - [Bib number management](bib-number-management.md) - [Managing the start list](managing-the-start-list.md) - [Race-day registration and check-in](race-day-registration-and-check-in.md) --- # Importing timing results URL: /en/running-events/importing-timing-results/ # Importing timing results Upload or sync finish times from external **timing providers** into DistantRace. **Path:** Competition → **Results → Import** ## Supported providers DistantRace integrates with common timing systems, including: - RFID Race Timing (rfidtiming.com) - Race Result (raceresult.com) - MyLaps (mylaps.com) - ALGE-TIMING (alge-timing.com) - SkiAlp-Pro / VOLA - RunScore ## File import 1. Export results from your timing software in the supported format. 2. Open **Results → Import → File**. 3. Upload the file and map distances if prompted. 4. Review imported times on the results page before publishing. ## URL sync **Results → Import → URL sync** pulls results automatically from a timing service URL on a schedule. Configure the URL and sync interval per provider documentation. ## Manual corrections After import, edit individual results (DNF, DNS, time corrections) from the results detail view. ## CSV participant import For bulk participant and result data, use the competition **Importer** tool (separate from timing import). ## Need help? Contact support@distantrace.com with your timing provider name if import formats are not listed. --- # Join codes and invitations URL: /en/running-events/join-codes-and-invitations/ # Join codes and invitations Control access to private and unlisted events with **shared passwords** or **individual join codes**. ## Shared join password **Settings → Base** — set one password for all participants when the event is private and you do not use individual codes. ## Individual join codes ### Club-wide codes **Club → Join Passwords** — codes valid across your private events. One participant per code. ### Per-event codes **Settings → Join Passwords** on a specific challenge or competition: - Create codes manually or **generate random batches** - Bind to a **distance** (competitions) - Pre-fill name, email, phone, birth date, external ID - **Activate / deactivate** or delete individual codes - **Delete all unused** — bulk-remove every code with no linked user (see below) - **Export** to XLSX for distribution - **Send email invitations** with magic links ::: tip One user per code Each individual code attaches to the first account that redeems it. The same user reuses that code for your other private events. ::: ## Delete all unused codes Bulk-delete codes that nobody has redeemed yet. Available on both **Club → Join Passwords** and **Settings → Join Passwords** on a specific event. **Path:** Join code list → **Delete All Unused** (toolbar) → confirm in modal → **Yes, delete** | Scope | What gets deleted | |-------|-------------------| | Club list | Unused club-wide codes (`user` is empty) for your organization | | Event list | Unused codes for that challenge or competition only | Codes already linked to a participant account are **not** affected. The action cannot be undone. ::: warning Export first If you still need to distribute printed codes or email batches, **Export XLSX** before deleting unused rows. ::: ## Email invitations From the join code list, send an invitation email. Recipients may be auto-enrolled if the event has no required apply questions — see [Email invitation links](../joining-events/email-invitation-links.md). ## Participant guides - [Using a join code](../joining-events/using-a-join-code.md) - [Email invitation links](../joining-events/email-invitation-links.md) ## Legacy documentation This replaces and extends the older club-level join passwords article. --- # Managing challenge participants URL: /en/running-events/managing-challenge-participants/ # Managing challenge participants **Path:** Challenge dashboard → **Participants** and **Workouts** ## Participant list View all enrolled challengers with team, distance, and sync status. Search and filter for support. ## Workouts review **Workouts** lists activities synced by participants. Use this to: - Verify activities were accepted or rejected by [rules](challenge-rules-and-activity-limits.md) - Manually accept workouts when rules excluded them incorrectly - Investigate missing data reported by participants For per-participant actions (add manual steps, [delete all results](editing-individual-challenge-participants.md#delete-all-results), change team, remove from challenge), open [Editing individual challenge participants](editing-individual-challenge-participants.md). ## Export Use **Export XLSX** on the Participants tab for challenger summaries, or **Export step data** on step challenges. Team exports are on the Teams tab. Full guide: [Exporting challenge data](exporting-challenge-data.md). Daily per-participant step rows: [Exporting step challenge daily results](exporting-step-challenge-daily-results.md). ## Participant slot limit Free and paid plans limit participant count. The walkthrough **slots** step links to upgrade when you approach the limit. ## Related - [Why activities are missing](../joining-events/why-activities-are-missing.md) (participant view) - [Challenge settings walkthrough](challenge-settings-walkthrough.md) --- # Managing challenge team standings URL: /en/running-events/managing-challenge-team-standings/ # Managing challenge team standings **Path:** Challenge dashboard → **Teams** ## Team results table Lists all teams with aggregate score (steps, distance, points, or active days depending on challenge type). Click a team to see member contributions. ## Export team standings **Teams → Export XLSX** downloads team totals and member scores — see [Exporting challenge data](exporting-challenge-data.md). ## Section team results When [stages](challenge-stages-and-section-standings.md) exist, open **Teams → Section** for period-limited team rankings. ## Top contributors limit Settings → **Advanced** → **Top results in team** caps how many members' scores count toward the team total. Documented in [Advanced challenge settings](advanced-challenge-settings.md#top-results-in-team). ## Team settings Configure team creation rules under Settings → **Teams** — participant-created vs pre-defined teams, privacy, join policy. ## Related - [Joining a team](../joining-events/joining-a-team.md) (participant view) - [Editing individual challenge participants](editing-individual-challenge-participants.md) — move member between teams --- # Managing competition teams URL: /en/running-events/managing-competition-teams/ # Managing competition teams **Path:** Competition → **Teams** ## Team list View all teams with member counts and captains. Filter by distance or status. ## Create a team **Teams → Create** — organizer-managed team with title, distance, and optional captain. Participants can join if registration rules allow team selection. ## Team detail - Add or remove members - View team payment status - Export roster ## Settings Configure team rules under Settings → **Teams** (per distance) and **Club teams** for organization-wide teams — see [Competition club teams](competition-club-teams.md). ## Related - [Joining a team](../joining-events/joining-a-team.md) - [Managing the start list](managing-the-start-list.md) --- # Managing individual racers URL: /en/running-events/managing-individual-racers/ # Managing individual racers Open a single **racer** (registration record) to fix details without bulk exports. **Path:** Competition → **Start list** → click participant name ## Edit registration - Custom question answers - Distance and team (when allowed) - Registration status (registered, cancelled, DNS) - Link to payment cart and invoice ## Multiple bib numbers Some formats assign more than one number per participant (relay legs, multi-day bibs, chip + display number): - **Set primary** — choose which number prints on the start list and confirmation - **Unassign number** — remove one number from the participant; the next assigned number becomes primary automatically Changes are logged on the racer record. ## Virtual competitions Virtual racers open a dedicated detail page from the start list: - Review **submitted workouts** and validation status - **Remove all results** — clears every workout and calculated time for this entry (standings recalculate) - **Add manual result** — enter finish time (hours/minutes/seconds) when GPS data is unavailable; replaces any existing result - Internal **comments** for staff notes (not visible to the participant) Activity accept/reject is also on the **Workouts** tab — [Reviewing virtual workouts](reviewing-virtual-workouts.md). ## Manual registration Add participants from **Start list → Add** when online registration is closed — see [Managing the start list](managing-the-start-list.md). ## Related - [Merging duplicate participants](../more-tools/merging-duplicate-participants.md) - [Managing orders and carts](managing-orders-and-carts.md) --- # Managing Omniva shipments URL: /en/running-events/managing-omniva-shipments/ # Managing Omniva shipments After participants buy physical products with Omniva delivery, manage shipments from the competition **Shipping** view. **Path:** Manager console → open competition → **Shipping** Requires [Omniva shipping integration](../integrations/omniva-shipping.md) with valid API credentials. ## Shipment list The table lists `ShippingData` rows for this event: | Column | Meaning | |--------|---------| | **ID** | Internal shipment record | | **Cart** | Link to order detail (`#cart-id`) — billing name, phone, and `shipping_data` | | **Product class** | Delivery provider (Omniva) | | **Tracking code** | Omniva barcode after labels are generated | | **Status** | Latest Omniva tracking event (updated automatically) | Filter and sort like other manager tables. Click the cart link to open [Managing orders and carts](managing-orders-and-carts.md) for the full order. Shipments are created from paid registrations that selected an Omniva parcel terminal — including orders completed via [Adding Omniva shipping after checkout](../joining-events/adding-omniva-shipping-after-checkout.md). ## Generate labels From the **Shipping** view or the Omniva integration panel, run **Generate shipments**: 1. DistantRace finds registered racers whose carts have `SHIPPING_OMNIVA` and no shipment row yet. 2. Orders with the same phone + parcel terminal are grouped into one parcel. 3. A background task calls the Omniva business API and saves tracking barcodes on each shipment row. You see a success message when generation starts (`m_omniva_generation_started`). Refresh the table after the task completes. ::: tip Import CSV Use **Import/export CSV** on the integration panel if you process labels outside DistantRace or need a file for the Omniva business portal. ::: ## Tracking and notifications - Omniva tracking events sync periodically; **Status** updates on each row. - When Omniva reports **picked up by courier**, participants receive a **shipped** email with tracking details (if not already sent). - Bib or finisher numbers linked to the order can move to **Shipped** status automatically. ## Fulfillment workflow 1. Connect [Omniva shipping](../integrations/omniva-shipping.md) and add Omniva shop products. 2. Participants choose a terminal at checkout or via the post-checkout link. 3. Open **Shipping** after registration closes (or as orders arrive). 4. **Generate shipments** → print labels → hand parcels to Omniva. 5. Monitor status until delivery; participants can contact you from the shipping email. ## Related - [Upsell products in checkout](upsell-products-in-checkout.md) - [Shop bought products list](shop-bought-products-list.md) - [Omniva shipping](../integrations/omniva-shipping.md) - [Adding Omniva shipping after checkout](../joining-events/adding-omniva-shipping-after-checkout.md) (participant view) --- # Managing orders and carts URL: /en/running-events/managing-orders-and-carts/ # Managing orders and carts Track every registration payment through **Finance → Orders**. **Path:** Manager console → Finance → **Orders** (carts) ## Order list Filter by status, event, payment method, or date. Each row shows buyer, total, payment channel, and registration status. | Status | Action needed | |--------|----------------| | Waiting payment | Bank transfer not yet received | | Payment received | Complete — participant on start list | | Cancelled | Abandoned or voided cart | ## Order detail Open an order to: - View line items (tickets, products, fees) - See linked participants and invoice PDFs - Mark bank-transfer orders as paid manually - Link to reserved entry (if applicable) - **Generate invoice** — create or refresh the PDF when payment is recorded but no invoice file exists yet - **Toggle email sending** — unsubscribe the buyer from cart-related reminder emails (useful when they asked to stop payment reminders) - Recalculate platform fees after corrections (superuser tools: remove or reset fee lines) ## Bank transfer orders When a participant chooses **prepay invoice**: 1. They receive a PDF with your bank details and invoice number 2. Payment arrives in your bank account 3. Match via [open banking](../finance-module/integration-with-banks.md) or mark paid in the order detail view 4. Registration completes automatically when marked paid ## Payment links Create one-off payment requests under Finance → Orders → **Add** — see [Creating a payment link](../finance-module/creating-a-payment-link.md). ## Refunds Supported payment channels allow partial or full refunds from Finance → **Transactions**. ## Related - [Invoicing](../finance-module/invoicing.md) - [Purchase summary](../finance-module/purchase-summary.md) - Participant view: [Downloading invoices and receipts](../joining-events/downloading-invoices-and-receipts.md) --- # Managing the start list URL: /en/running-events/managing-the-start-list/ # Managing the start list For **competitions**, the **Start list** is the operational center for registered participants. **Path:** Competition dashboard → **Start list** ## View and search Search by name, bib, email, or number. Filter by distance and payment status. ## Add participants manually - **Pick participant** — search existing club participants - **Add new** — manual registration when online registration is closed or for on-site entries ## Edit entries Open a participant row to update details, payment status, products, and linked orders. ## Merge duplicates **Start list → Merge** combines duplicate registrations for the same person. Useful after import errors or double signups. ## Import from spreadsheet Upload an **.xlsx** file to assign bib numbers in bulk — [Importing the start list from a spreadsheet](importing-start-list-from-spreadsheet.md). ## Export start list From the start list action buttons: | Export | Content | |--------|---------| | **Export XLSX** (per distances) | One worksheet per distance — bib, contact, payment, products, and **custom registration question** answers | | **Full start list** | All registered participants on a single sheet — includes [registration form questions](registration-form-questions.md) as columns | | **Export Marketing XLSX** | Contact data plus marketing consent answers for this competition | ### Marketing export details The marketing export (`start_list_marketing_export.xlsx`) includes **every non-anonymous participant** on the start list, regardless of registration status (registered, pending, withdrawn, etc.). Fixed columns: | Column | Content | |--------|---------| | ID | Racer ID | | Created | Registration timestamp (club timezone) | | Last Name / First Name | Participant name | | Birthday / Gender | Demographics | | E-mail / Phone / Country | Contact fields | | Distance | Registered distance | | Status | Current registration status | Additional columns — one per club [marketing preference question](marketing-preferences-on-registration.md) — use each question's **short name** as the header. Values come from answers stored at checkout (`true`/`false` for checkboxes, or the selected option). ::: tip vs. club-wide email export This export is **scoped to one competition**. For filtered lists across many events, use [Marketing email export filters](marketing-email-export-filters.md) under Marketing → Export emails. ::: Exports are asynchronous — download from [Organizer documents](../more-tools/organizer-documents.md). ::: note Privacy Use marketing exports only for contacts who consented. See [Marketing email export filters](marketing-email-export-filters.md) for filtered club-wide lists. ::: ## Virtual vs in-person rows - **In-person racers** — payment, tickets, bib assignment - **Virtual racers** — linked workouts and calculated times ## Related - [Bib number management](bib-number-management.md) - [Race-day registration and check-in](race-day-registration-and-check-in.md) - [Partner and corporate registration](partner-and-corporate-registration.md) - [Registration form questions](registration-form-questions.md) — answers appear in start list exports --- # Managing tickets and pricing URL: /en/running-events/managing-tickets-and-pricing/ # Managing tickets and pricing In-person and virtual **competitions** use **tickets** (one per distance or category) with optional tiered pricing. **Path:** Open competition → **Tickets** Requires at least one **published** [payment channel](../finance-module/integrations-with-payment-systems.md). ## Enable tickets Competition settings must have tickets enabled. The ticket list is empty until you create tickets and prices. ## Create a ticket 1. Tickets → **Add ticket** 2. Set: - **Distance** — links ticket to a competition distance - **Age range** — `from_year` / `till_year` for age-group tickets - **Status** — draft or published - **Order** — display order at checkout - **Description** — shown to participants - **Emergency contact / billing phone** — optional required fields - **Bulk discount** — allow quantity discounts 3. Save ## Set prices Open a ticket → **Prices** tab: 1. Add price rows with amount, currency, start/end dates (early bird windows) 2. Multiple active prices create time-based tiers automatically 3. Free tickets use price €0 ## Sold tickets View registrations per ticket under competition → **Sold tickets** (Finance area). Use **Export XLSX** for spreadsheets — [Purchase summary](../finance-module/purchase-summary.md). Ticket scanning: [Mobile ticket scanning for organizers](mobile-ticket-scanning-for-organizers.md). ## Race-day tickets Create separate tickets marked for race-day registration — see [Race-day registration and check-in](race-day-registration-and-check-in.md). ## Copy tickets from another competition When you run a **series** or repeat the same distance setup each year, copy ticket definitions instead of recreating them: 1. Tickets list → **Copy tickets** 2. Select a **source competition** in the same club (sibling stage or previous edition) 3. Confirm — distances, age ranges, and price tiers copy to the current event Review copied prices and registration dates before publishing — early-bird windows do not shift automatically. ## Related - [Create an in-person race](create-an-in-person-race.md) - [Discount codes](../finance-module/discount-codes.md) - [Upsell products in checkout](upsell-products-in-checkout.md) --- # Marketing email export filters URL: /en/running-events/marketing-email-export-filters/ # Marketing email export filters Export **registered participant** contact data as CSV for [Listmonk](../integrations/listmonk.md), spreadsheets, or manual campaigns. This export covers people who completed registration (racers/challengers), **not** the Club → **Interested** pre-registration list. For leads who have not registered yet, see [Collecting interested participants](collecting-interested-participants.md). **Path:** Manager console → Marketing → **Export emails** You can also open the export from the Marketing dashboard quick link. ## Build a filter | Field | Effect | |-------|--------| | **Races** (`events_included`) | Include participants registered in these events (challenges or competitions) | | **Excluded races** (`events_excluded`) | Drop racer rows from these events; participants only in excluded events are omitted entirely | Event labels show year and name (same format as SMS campaign pickers). Select one or many events per side. ## Preview count **Preview** calls a live JSON endpoint and shows: - How many email addresses match - A small sample list Use preview before download to avoid accidental bulk exports. ## Download format Submitting the form streams a CSV named `email-export--.csv` with columns: | Column | Content | |--------|---------| | `first_name` | Participant first name | | `last_name` | Participant last name | | `email` | Email address | | `last_competition` | Name of their most recent competition in this club | | `last_competition_date` | Start date of that competition (ISO format) | Org-wide marketing unsubscribers (`Unsubscriber.everything = true`) are excluded automatically. ## Privacy Only export contacts who opted in where required. See [Marketing preferences on registration](marketing-preferences-on-registration.md). Imported lists in Listmonk or Omnisend should respect the same consent boundaries. ## Related - [Email templates and export](../integrations/email-templates-and-export.md) - [Marketing to participants](marketing-to-participants.md) - [Collecting interested participants](collecting-interested-participants.md) --- # Marketing preferences on registration URL: /en/running-events/marketing-preferences-on-registration/ # Marketing preferences on registration Clubs can add **marketing preference questions** to registration checkout — typically opt-in checkboxes for email newsletters or SMS updates. ## Configure preferences **Path:** Manager console → Marketing → **Preferences** Create questions per language: - Checkbox or radio input - Required or optional - Label shown at checkout Questions appear on the participant checkout form under **Marketing preferences**. ## Omnisend mapping When [Omnisend](../integrations/omnisend.md) is connected, map a preference question so opted-in participants are subscribed in Omnisend automatically. ## Privacy Only message participants who opted in. See [Marketing to participants](marketing-to-participants.md). ## Related - [Email templates and export](../integrations/email-templates-and-export.md) - [Registration settings](challenge-settings-reference.md) --- # Marketing to participants URL: /en/running-events/marketing-to-participants/ # Marketing to participants DistantRace includes **marketing tools** to message people who registered for your events. ## Channels | Channel | Setup | |---------|--------| | Email templates | Manager → Marketing → Email templates | | SMS / WhatsApp | Requires [Twilio integration](../integrations/twilio.md) | | Campaigns | Target participants of selected events | ## Email list export Download registered participant emails as CSV — [Marketing email export filters](marketing-email-export-filters.md). Pre-registration **Interested** leads are managed separately — [Collecting interested participants](collecting-interested-participants.md). ## Email templates Create reusable templates with event variables (name, dates, links). Preview rendered HTML and send test messages before going live. Send to participant lists filtered by event or club. See [Email templates and export](../integrations/email-templates-and-export.md). ## SMS campaigns Connect [Text2Reach](../integrations/text2reach.md), [SMS Server Tools](../integrations/sms-server-tools.md), or [Twilio](../integrations/twilio.md) and send bulk SMS — [SMS campaigns](../integrations/sms-campaigns.md). ## WhatsApp campaigns After Twilio WhatsApp is configured, create campaigns with approved templates — [WhatsApp campaigns](../integrations/whatsapp-campaigns.md). Participants must have valid phone numbers from registration. ## Hero / header images White-label club and event header images for public pages and emails (club branding settings). ## Integrations - [Introduction to integrations](../integrations/introduction-to-integrations.md) - [Listmonk](../integrations/listmonk.md) - [Omnisend](../integrations/omnisend.md) - [SendGrid](../integrations/sendgrid.md) ## Privacy Only message participants who provided contact details, in accordance with consent collected on registration forms. --- # Mobile ticket scanning for organizers URL: /en/running-events/mobile-ticket-scanning-for-organizers/ # Mobile ticket scanning for organizers For **ticket-based in-person races**, volunteers can scan participant ticket codes at the registration desk using the **DistantRace mobile app** — without full manager console access. ## Ticket Scan role Invite staff with **Ticket scan** permission from **Club → Members** — see [Club settings and admins](club-settings-and-admins.md). | Role | Can scan tickets | Can open manager console | |------|------------------|--------------------------| | Ticket scan | Yes | No (mobile app only) | | Support team | Yes (if also invited) | Yes | | Administrator | Yes | Yes | Ticket scan users must log into the mobile app with the same DistantRace account that received the invite. ## What gets scanned Each paid registration for a ticket-race competition generates an **EventTicket** with a unique code (also on PDF tickets and confirmation emails). When a code scans successfully: - Status changes to **Used** - Timestamp is recorded - Duplicate scans return **Already used** Invalid or unknown codes show **Not found**. ## At the venue 1. Open the DistantRace mobile app while logged in as a Ticket scan user 2. Open the **scanner** (QR / barcode) 3. Scan the participant's ticket code from email, PDF, or screen 4. Confirm the app shows **valid** before handing over a bib or kit For race-day QR registrations (after online payment closes), see [Race-day registration and check-in](race-day-registration-and-check-in.md) — workflow may combine QR apply codes with on-site payment recording. ## Track scans in the console Administrators view sold and scanned tickets under the competition **Sold tickets** list — [Purchase summary](../finance-module/purchase-summary.md). Export ticket status to Excel for reconciliation after race day. ## Related - [Managing tickets and pricing](managing-tickets-and-pricing.md) - [Race-day registration and check-in](race-day-registration-and-check-in.md) - [Managing the start list](managing-the-start-list.md) --- # Multi-distance challenges URL: /en/running-events/multi-distance-challenges/ # Multi-distance challenges **Distance-kind** challenges can offer several enrollment categories (for example 5 km, 10 km, half marathon). **Path:** Settings → Distances ## Configure distances Add each distance with name, length, status (published/unpublished), and optional caps on participant count. **Delete distance** removes a category. Existing challengers on that distance revert to no-distance scoring — DistantRace warns how many participants are affected. ## Multiple enrollment Enable **Allow multiple distances** in **Settings → Advanced** so one participant can hold several distance rows. ## Apply flow Participants select distances on the registration form. Activities route to the appropriate challenger row. ## Per-section caps When using **stages**, you can cap distance counted per stage — useful for monthly sub-competitions. ## Participants [Participate in a challenge](../joining-events/participate-in-a-challenge.md) — multi-distance section. --- # On-site payment and in-store registration URL: /en/running-events/on-site-payment-and-in-store-registration/ # On-site payment and in-store registration When participants register at the **registration tent** (race-day QR flow or walk-ups), staff record payment in the manager console. **Path:** Finance → Orders → open order → **On-site** view, or competition → participant → on-site tools ## Race-day flow 1. Participant completes [race-day registration](race-day-registration-and-check-in.md) and receives a QR code 2. Staff scan or look up the cart 3. Open the **on-site** order view 4. Record payment method (cash, card terminal, etc.) 5. Assign bib number and hand out materials ## Connect to existing registration Race-day desks often see someone who **already registered online** under a different email or a guest profile. Link the on-site cart to their existing entry instead of creating duplicates. **Path:** Finance → Orders → open on-site cart (QR scan layout) ### When a match appears DistantRace scans **sibling competitions in the same series** (same parent event) for a prior entry that matches: - Same **full name** (normalized) - Same **birth year** - Same **distance** - Status **registered** (not withdrawn) When found, a red alert shows the prior participant, competition, and bib number (if any). Click the button in that alert — labeled **Unable to Register** in the UI — to run **Connect and register**. ### What connect and register does The action runs over AJAX (no full page reload): 1. **Merges participant profiles** — if the prior entry has a linked user account, that profile is kept; otherwise the on-site profile is kept 2. **Copies the bib number** from the prior entry onto the on-site racer 3. Sets the on-site racer status to **registered** On success you see a confirmation message. The alert is removed from the screen. ### When no match appears Assign a bib with **Register Participant** as usual, or merge profiles later with [Merge participants](../more-tools/merging-duplicate-participants.md). Participant self-service linking: [Linking a participant profile](../joining-events/linking-a-participant-profile.md). ## Bib assignment From the on-site view assign the next available bib or enter a specific number. The system checks the number is not already used. ## In-store cart status On-site carts use a dedicated status so they appear separately from online checkouts in the order list. Mark paid when money is received. ## Related - [Race-day registration and check-in](race-day-registration-and-check-in.md) - [Managing orders and carts](managing-orders-and-carts.md) - [Bib number management](bib-number-management.md) --- # Participant event reviews URL: /en/running-events/participant-event-reviews/ # Participant event reviews After an event, participants can leave a **star rating** (1–5) and written review. **Path:** Competition dashboard → **Reviews** ::: note Competitions only The Reviews tab is available on **competition** dashboards, not challenges. ::: ## Review list Each row shows rating, review text, participant name, and submission date. Filter by rating or search text. ## Use feedback - Identify registration or race-day pain points - Follow up with low ratings via [Marketing](marketing-to-participants.md) - Share testimonials (with permission) on club pages ## Reply to a review On the review list or competition dashboard widget: 1. Open a review without a response 2. Write your **public reply** in the response field 3. Submit — DistantRace emails the participant that you responded You can **delete** a reply later if needed. Replies appear publicly next to the participant's review. Reviews are separate from [virtual workout validation](reviewing-virtual-workouts.md) — they measure satisfaction, not GPS quality. ## Related - [Collecting interested participants](collecting-interested-participants.md) - [Marketing preferences on registration](marketing-preferences-on-registration.md) --- # Registration for clients and partners URL: /en/running-events/partner-and-corporate-registration/ # Registration for clients and partners In the DistantRace system, it is possible to add private registration links for partners and supporters, and there may be other use cases as well. Various parameters can be defined for such registrations: - "Title" — a name can be attached to each link. For example, Company ABC. - "Discount" — the discount amount. For each registration link, you can define the discount amount. - "Start" — when registration via this link opens. - "End" — when registration via this link closes. - "Status" — Published / Unpublished. If the link needs to be taken down so it is no longer available, change the status to "Unpublished". - "Available Distance" — you can define which distances can be registered for with this link. - "Manual Registration" — if manual registration is enabled, the participant only appears in the start list after manual processing by the organizer. - "Participants Allowed" — how many participants are allowed to register with this link. - "Participants Left" — how many participant slots are left on this link. ![](/static/img/real-race-management/registration-for-clients-and-partners/image-1712662549617-35-44.png) Once a participant has registered, they will be visible in the "Participant" list, and it is also possible to export the participants who registered via a specific link. ## Dynamic group carts (participants) Individual participants can also create a **dynamic cart** from their account to pay for colleagues — see [My purchases and orders](../joining-events/my-purchases-and-orders.md#create-a-group-registration-cart-dynamic-cart). That flow is separate from organizer **reserved entries** but uses the same shared-checkout model. ## Related - [Reserved entries](reserved-entries.md) - [Joining via dynamic cart link](../joining-events/joining-via-dynamic-cart-link.md) --- # Points challenges URL: /en/running-events/points-challenges/ # Points challenges **Points challenges** let participants earn **points per kilometre** (or related metrics) across selected sports. Flexible for multi-sport events. ## Create a points challenge 1. **Create new Event** → base data. 2. Step 2: under **Most popular**, select **Points challenge**. 3. Create — default sports with points per km are preconfigured. ## Configure scoring 1. **Settings → Sports** — add/remove sports, set points per km, aliases (e.g. orienteering → run). 2. **Settings → Rules** — activity limits, GPS, sync window. 3. **Settings → Advanced** — result ordering, energy display if used. ## Result tables Enable per-sport columns in **Settings → Display of results**. ## Difference from running/cycling challenges Running and cycling presets focus on one sport family. Points challenges start with a broader multi-sport points model you customize. ## Participants [Participate in a challenge](../joining-events/participate-in-a-challenge.md) — activities must use accepted sports connected to DistantRace. --- # Premium registration packages URL: /en/running-events/premium-registration-packages/ # Premium registration packages **Premium packages** are optional paid tiers shown during registration — for example "Standard" vs "VIP" with different perks, merchandise, or start-wave priority. ## How participants see them On the registration or **confirmation** page, participants pick one package (or the default free tier). Each tier may show: - Title, description, and price - Icon and color styling - Extra registration **questions** specific to that tier - Shipping requirement for physical perks Participant guide: [Post-registration add-ons](../joining-events/post-registration-add-ons.md). ## Dashboard statistics When premium levels exist, the **competition dashboard** shows how many participants chose each tier — [Competition dashboard analytics](competition-dashboard-analytics.md). ## Configuration Premium levels are tied to the event in the backend (Django admin / platform setup). There is no self-service premium editor in the standard manager UI yet — contact DistantRace support to add or change tiers. Each level can: - Set **price** (VAT inclusive) - Attach **questions** participants must answer when selecting the tier - Assign a **group** label used internally for reporting or bib waves - Require **shipping** for included physical goods ## Payments Premium charges are added to the participant's **cart** like tickets or products. Refunds follow [Refunds and transactions](../finance-module/refunds-and-transactions.md). ## Related - [Managing tickets and pricing](managing-tickets-and-pricing.md) - [Upsell products in checkout](upsell-products-in-checkout.md) - [Managing orders and carts](managing-orders-and-carts.md) --- # Race-day registration and check-in URL: /en/running-events/race-day-registration-and-check-in/ # Race-day registration and check-in Let participants **register after online payment closes** and check in with a **QR code** on race day. ## How it works for participants 1. Participants open the same registration link as before, but only for **one person** at a time. 2. After submitting the form, they see a **QR code** on screen and receive it by email. 3. On race day they present the QR at the registration tent. 4. Staff scan the code, verify payment, assign a bib, and confirm start list entry. See [Register for in-person competitions](../joining-events/register-for-in-person-competitions.md). ## Enable for organizers ### Registration settings 1. Go to **Settings → Registration**. 2. Set **The end of online payments** — when card payments stop. 3. Enable **registration form once online payments are closed** (race-day QR apply). 4. Save. ![](/static/img/real-race-management/registration-for-the-competition-on-the-day-of-the-event-or-after-online-payments-have-been-disabled/image-1717657934339-12-08.png) ### Race-day tickets Configure which distances and **informative fees** apply on race day: 1. Open **Tickets** → select or create a ticket. 2. **Add New Fee** for the race-day price (informational — no online payment). 3. Participants select this ticket and complete the form. ![](/static/img/real-race-management/registration-for-the-competition-on-the-day-of-the-event-or-after-online-payments-have-been-disabled/image-1717658683920-24-39.png) ## On-site payment Use the on-site cart tools in the manager console to record payment when participants pay at the tent — see [On-site payment and in-store registration](on-site-payment-and-in-store-registration.md). ## Ticket scanning For ticket-race formats, assign volunteers the **Ticket scan** role and use the mobile app scanner — [Mobile ticket scanning for organizers](mobile-ticket-scanning-for-organizers.md). ## Related - [Checkpoint passages](checkpoint-passages.md) - [Managing the start list](managing-the-start-list.md) - [Mobile ticket scanning for organizers](mobile-ticket-scanning-for-organizers.md) --- # Registration form questions URL: /en/running-events/registration-form-questions/ # Registration form questions Collect extra information during registration — t-shirt size, emergency contact, dietary needs, or corporate department. **Path (challenge):** Challenge → Settings → **Questions** **Path (competition):** Competition → Settings → **Questions** ## Question types | Type | Use for | |------|---------| | **Text** | Free-form short answer | | **Choice** | Dropdown or radio — one option per line in the choices field | | **Checkbox** | Yes/no consent or opt-in | | **Number** | Numeric values (bib preference, estimated finish time in minutes, etc.) | ## Question settings | Field | Meaning | |-------|-------| | **Question** | Label shown on the registration form | | **Order** | Sort order among other questions (lower = higher) | | **Required** | Participant cannot submit without an answer | | **Published** | Hidden when unpublished — useful while drafting | | **Distance** *(competitions only)* | Limit the question to one distance, or leave as **All distances** | Answers appear on the participant profile in the manager console and in exports: | Event type | Where to export answers | |------------|-------------------------| | **Challenge** | Challenge → **Participants** → **Export XLSX** — one column per custom question ([Exporting challenge data](exporting-challenge-data.md)) | | **Competition** | Start list → **Full start list** or **Per distances** export — answers included for each racer ([Managing the start list](managing-the-start-list.md)) | | **Either** | Open the participant row and edit answers directly — [Managing individual racers](managing-individual-racers.md) or [Editing individual challenge participants](editing-individual-challenge-participants.md) | ## Email invitations and join codes Events with **required** custom questions cannot use one-click [email invitation links](../joining-events/email-invitation-links.md) — participants must complete the full form. ## Marketing vs registration questions Registration questions are for event-specific data. Club-wide **marketing preferences** (newsletter opt-in) are separate — see [Marketing preferences on registration](marketing-preferences-on-registration.md). ## Related - [Event info pages and regulations](event-info-pages-and-regulations.md) - [Managing the start list](managing-the-start-list.md) — export includes custom answers - [Reserved entries](reserved-entries.md) — pre-filled registration links --- # Reserved entries URL: /en/running-events/reserved-entries/ # Reserved entries **Reserved entries** let organizers invite specific people to register with pre-defined conditions — free entry, fixed price, hidden from public listing, or manual approval. **Path:** Open competition → **Reserved entries** ## Create a reserved entry 1. Reserved entries → **Create** 2. Set title, linked ticket/distance, price override (or free) 3. Options: - **Free registration** — skip payment fields at checkout - **Manual registration** — organizer confirms before start list - **Hidden** — only accessible via direct link 4. Save and copy the **registration link** to send to the participant ## Participant experience The participant opens the link, fills a shortened form, and completes checkout (or registers free). The cart is tied to the reserved entry for tracking. ## Manage entries Reserved entry detail shows linked carts, payment status, and participants. Edit or deactivate entries when full. ## Bulk register or remove (in-person) On **in-person races only** (not virtual competitions), the reserved entry detail page lists participants with checkboxes: | Action | Effect | |--------|--------| | **Register all** | Moves **selected** entries that are not yet registered to **registered** status on the start list | | **Remove all** | Withdraws **selected** entries that are already **registered** | ::: note Selection required You must tick one or more rows before running a bulk action. Actions only affect the checked participants. ::: Use after importing partner lists or correcting a batch of manual entries — for example when **Manual registration** was enabled and you need to confirm many entries at once. Individual **Register** / **Remove** row actions work on single participants without selecting checkboxes. **Ticket-race** formats show sold tickets instead of a start-list table; bulk register/remove applies to the underlying racer records the same way. ::: warning Virtual competitions Reserved entries are not available for virtual races. Create reserved entries only on in-person ticket or standard race formats. ::: ## Export participants or tickets **Export** on the reserved entry detail generates: - **Participant export** — spreadsheet of racers linked to this reserved entry - **Ticket export** — for ticket-race formats Files process in the background and appear under [Organizer documents](../more-tools/organizer-documents.md). Participant flow: [Using a reserved entry link](../joining-events/using-a-reserved-entry-link.md). ## Related - [Partner and corporate registration](partner-and-corporate-registration.md) - [Managing orders and carts](managing-orders-and-carts.md) - [Discount codes](../finance-module/discount-codes.md) --- # Results URL sync URL: /en/running-events/results-url-sync/ # Results URL sync Schedule automatic imports from a **timing provider URL** instead of uploading files manually. **Path:** Competition → **Results → Import → URL sync** ## Create a sync job 1. Results → Import → **URL sync** → **Add** 2. Enter the provider URL (from Race Result, MyLaps, RFID Timing, etc.) 3. Set sync interval (how often DistantRace fetches updates) 4. Map external distances to your competition distances — see [Distance sync mapping](competition-distance-sync-mapping.md) 5. Save and enable ## Monitor imports The sync list shows last run time, status, and row counts. Failed syncs log errors — verify URL credentials and distance mappings. ## When to use URL sync vs file import | Method | Best for | |--------|----------| | **URL sync** | Live results during the race; provider offers a stable results URL | | [File import](importing-timing-results.md) | One-off upload after the event; custom exports | ## Related - [Importing timing results](importing-timing-results.md) - [Publishing results](../results/publishing-results.md) --- # Reviewing virtual workouts URL: /en/running-events/reviewing-virtual-workouts/ # Reviewing virtual workouts For **virtual competitions**, participants submit one or more GPS-tracked workouts. Organizers review them under **Workouts**. **Path:** Competition → **Workouts** ## What you see Each row shows the participant, activity source, distance covered, calculated time to target distance, and validation status. ## Invalid activities Activities may be rejected when: - GPS data is missing or insufficient - Distance does not reach the required amount - Activity falls outside the competition window - Sport type is not accepted ## Manual review Open a workout to inspect the track and result calculation. Contact the participant or adjust results if your rules allow. ## Per-workout actions On a workout detail page you can override automatic validation: | Action | When to use | |--------|-------------| | **Set as result** | Accept this workout as the participant's official time — replaces any existing result and recalculates standings | | **Delete result** | Remove this workout from scoring. If the competition uses **best workout** rules, the next-best remaining activity becomes the result automatically | | **Add penalty** | Add seconds to the calculated time (e.g. rule violation). Enter penalty in seconds — standings and team scores recalculate | Each action is logged in the workout history for audit. Flagged activities show the reason DistantRace rejected the GPS data (missing track, insufficient distance, etc.) before you override. ## Remove all results (per participant) On a **virtual racer detail** page (start list → open virtual entry), **Remove all results** clears every submitted workout and deletes calculated results for that participant. Standings and team scores recalculate automatically. Use when: - All synced activities are invalid and the participant must re-submit - A data import error attached wrong workouts - Fair-play decision to reset one entry only For challenge participants, the equivalent is **Remove all activities** on the challenger detail — [Editing individual challenge participants](editing-individual-challenge-participants.md). ## Related - [Competition sports settings](competition-sports-settings.md) - [Create a virtual competition](create-a-virtual-competition.md) - [Participate in virtual competitions](../joining-events/participate-in-virtual-competitions.md) --- # Season pass and multi-stage competitions URL: /en/running-events/season-pass-and-multi-stage-competitions/ # Season pass and multi-stage competitions Some organizers run a **season pass** (collection competition) — one parent event that contains several child races. Participants may register once for the series and appear in each stage, or move between stages as the season progresses. **Path:** Competition list → open parent **collection** event, or child stage under it ## Structure | Level | Meaning | |-------|---------| | **Parent (collection)** | Season pass container — holds child competitions | | **Child stage** | Individual race (virtual, in-person, or distant race) within the series | | **Third level** | Some setups nest a stage under a sub-series | Child events inherit club branding but have their own start list, distances, and results. ## Registration behavior When someone registers for a **collection** parent, DistantRace can create matching entries on child competitions automatically (depending on configuration). Check each child **Start list** after bulk imports. Paid season passes link one cart to multiple stage entries — see [Managing orders and carts](managing-orders-and-carts.md). ## Transfer between stages For **stage** competitions (child races in a series), organizers can move a participant to a **future stage** that has not started yet, as long as they have **no published result** on the current stage. **Path:** Start list → open participant → **Transfer** → choose target stage → **Save** The transfer: - Moves the registration to the new stage competition - Clears bib numbers that belonged only to the old stage - Recreates **team** membership on the target stage if the participant was on a team Participants cannot self-transfer — organizers perform this from the console. ## Results and standings Each child stage has its own **Results** tab. Series-wide standings (if configured) aggregate points across stages — see [Standings and rankings](../results/standings-and-rankings.md). ## Related - [Managing the start list](managing-the-start-list.md) - [Managing individual racers](managing-individual-racers.md) - [Create an in-person race](create-an-in-person-race.md) - [Create a virtual competition](create-a-virtual-competition.md) --- # Share your event (Easy Access) URL: /en/running-events/share-your-event-easy-access/ # Share your event (Easy Access) **Easy Access** is the sharing hub for challenges and competitions. Open it from the challenge dashboard or at the end of the [settings walkthrough](challenge-settings-walkthrough.md). URL: `/console//challenges//easy_access/` (or competitions equivalent). ## What you get | Asset | Use | |-------|-----| | **QR code** | Posters, slides, race expo | | **Share link** | Email, chat, social | | **Short join code** | Manual entry in app or web | | **Onboarding URLs** | Per-language participant instruction pages | ## Onboarding pages Each language configured on the event has an onboarding URL participants can open before registering. Content matches the in-app [challenge onboarding page](../joining-events/challenge-onboarding-page.md). ## Private events For unlisted/private events, only people with the link or code can register. Combine with [Join codes and invitations](join-codes-and-invitations.md). ## Video walkthrough [![Create and invite](https://img.youtube.com/vi/1fGOxaBgK6A/0.jpg)](https://www.youtube.com/watch?v=1fGOxaBgK6A) Legacy screenshots from the Access section: ![](/static/img/daily-step-challenges/how-to-send-an-invitation-for-others-to-join/image-1712578425681-12-34.png) ## After sharing Monitor registrations under **Participants** or **Start list** depending on event type. --- # Shop bought products list URL: /en/running-events/shop-bought-products-list/ # Shop bought products list Track every **physical or digital product** sold through registration checkout. **Path:** Manager console → Shop → **Bought products** ## List view Each row shows product, variation, participant, event, cart payment status, and order date. Filter by event or product type. ## Export Export to Excel — file queues under [Organizer documents](../more-tools/organizer-documents.md). ## Fulfillment Use with [Managing Omniva shipments](managing-omniva-shipments.md) for parcel delivery or pickup lists for race-day handout. ## Related - [Upsell products in checkout](upsell-products-in-checkout.md) - [Purchase summary](../finance-module/purchase-summary.md) --- # Step game URL: /en/running-events/step-game/ # Step game The **step game** adds sequential **daily tasks** (goals) participants complete during a step or combined challenge. A default step game is created automatically for new step and combined challenges. ## Open step game settings From the challenge dashboard: **Step game** in the menu, or the walkthrough **Step game** step. URL pattern: `/console//challenges//step_game/` ## Enable or disable - **Step game on/off** — show tasks to participants. Turning off **deletes all configured tasks** — re-add them if you enable again. - **Scoring on/off** — award points for completing tasks (when combined with points rules). Use **Update points** after editing per-task point values in combined challenges. ## Tasks (goals) Each task has: - **Order** — sequence participants follow - **Target** — steps or other unit for that day/period - **Points** — optional bonus when scoring is enabled Add, edit, or reorder tasks from the step game page. ## Participant experience Participants see **Step game** on the challenge navigation when enabled. Completed tasks update their points total. Participant guide: [Step game daily tasks](../joining-events/step-game-daily-tasks.md). ## Related settings - Step point tiers in [Advanced challenge settings](advanced-challenge-settings.md) - Combined scoring in [Combined challenges](combined-challenges.md) --- # Upgrading participant limits URL: /en/running-events/upgrading-participant-limits/ # Upgrading participant limits Free and paid plans cap how many people can join an event. When you approach the limit, upgrade from the challenge walkthrough or event upgrade page. ## When you need an upgrade The settings walkthrough **Slots** step shows used vs allowed participants. Paid plans include a base allowance; larger events need additional slots. ## Upgrade options Open the event → **Upgrade** (linked from the walkthrough slots step). | Option | Description | |--------|-------------| | **Buy more participants** | One-time purchase of additional slots for this event | | **Subscribe** | Monthly subscription for a fixed participant cap across events | | **Resume subscription** | Reactivate a lapsed subscription at the same tier | ## Minimum purchase Upgrades below **50 participants** are rounded up to 50 unless the event already allows 60+ participants. ## Pricing tiers - **Pro** — €1 per participant per month - **Pro+ Assisted** — €3 per participant per month (includes DistantRace setup support) VAT is calculated from your club's country and VAT registration. See [Costs and pricing](costs-and-pricing.md). ## Checkout Upgrade purchases go through the standard shop checkout (card payment). After payment, the event's `max_participant_count` increases immediately. You receive a PDF invoice — see [Invoices for platform services](../finance-module/invoices-for-platform-services.md). ## Related - [Invoices for platform services](../finance-module/invoices-for-platform-services.md) - [Managing challenge participants](managing-challenge-participants.md) - [Challenge settings walkthrough](challenge-settings-walkthrough.md) --- # Upsell products in checkout URL: /en/running-events/upsell-products-in-checkout/ # Upsell products in checkout Organizers can manage **upsell products** that participants see during registration or checkout (e.g. event t‑shirts, insurance, extra services). This is done in the organizer console under **Shop → Products**. **URL (example):** `https://distantrace.com/en/console/{org_code}/shop/products/` --- ## 1. Products list (Upsell products) The main view lists all products for your organization. ### Columns | Column | Description | |--------|-------------| | **Title** | Product name (click to edit). | | **Event** | Event the product is linked to. | | **Kind** | e.g. Apply form product, Add-on product, Participant/Distance replacement. | | **Price** | Single price, or **“min – max”** with currency when the product has **variations** (e.g. Early bird / Standard). | | **Available from / till** | Date range when the product is available. | | **Is published?** | Whether the product is visible to participants. | ### Filters - **Search** – By product title, short name, or description. - **Event** – Limit to one event or “All events”. - **Availability** – **Active** (available till ≥ today or no end date) or **Expired** (available till < today). - **Is published?** – Yes / No. ### Actions - **Create product** – Opens the new product form. - **Export XLSX** – Exports the product list. The file is generated in the background and can be downloaded from **Documents**. --- ## 2. Create / Edit product Create a new product or open an existing one from the list to edit. ### Basic fields - **Event** – Event this product belongs to (required). Only future events shown for new products. - **Distance** – Optional; tie the product to a specific distance. - **Title** – Display name. - **Help text** – Shown next to the product in the flow. - **Short name** – Internal or short label. - **Price** – Amount and currency (single price when you are not using variations). - **Available from / Available till** – When the product can be purchased. - **Is published?** – If unchecked, the product is hidden from participants. - **Is required?** – Whether the participant must choose something (e.g. accept or pick an option). - **Default value** – Pre-selected value: `true`, a choice key from **Product choices**, or a product variation code. - **Description** – Rich text (WYSIWYG) for product details. - **Image background color** – Background color behind the product image (optional). ### Product type (Kind) You can choose one of: - **Apply form product** – Shown in the apply/registration form. Can use either **Product variations** or **Product choices/stock** (not both). - **Add-on product participant** – Add-on that is assigned per participant. - **Add on product** – Add-on with a **Product class** (e.g. Single-choice product, Insurance, Omniva). - **Participant Replacement** – For changing participants in the start list. Participant guide: [Transferring your registration to someone else](../joining-events/transferring-your-registration-to-someone-else.md). - **Distance Replacement** – For changing a participant’s distance. If you choose **Add on product**, the **Product class** field is shown and is required (e.g. Single-choice product, Insurance, Omniva). ### Product variations (Apply form product only) For **Apply form product** you can define **variations** (e.g. “Early bird”, “Standard”) instead of using choices/stock. - **Title** – Variation name (e.g. “Early bird”). - **Price** – Price for this variation (amount and currency on one line). - **Group name** – Groups variations together in the UI. - **Published** – Whether this variation is available. Use **Add variation** to add more rows. You cannot use both **Product variations** and **Product choices / stock** for the same product; the form will hide one section once you start using the other, and the server will show an error if both are filled. ### Product choices / stock (Apply form product only) For **Apply form product** you can define **choices** (e.g. sizes, options) and optional stock instead of using variations. - **Manage stock** – Switch to show/hide **Initial stock** and **Stock left** columns. - Table columns: - **Choice key** – Internal key (e.g. `S`, `M`, `L`). - **Choice name** – Label shown to participants. - **Initial stock** / **Stock left** – Shown only when “Manage stock” is on. - **Disabled** – Hides that option from selection. Use **Add choice** to add rows. As above, you cannot combine this with **Product variations** for the same product. ### Other options - **Main image** – Product image. - **Add to event** / **Add to child events** – Whether the product is offered on the event and/or its child events. ### Saving and deleting - **Save** – Saves the product and stays on the edit page. - **Delete** – Only on edit; deletes the product after confirmation. --- ## 3. Bought products This view lists **purchased** products (each row is a product bought by a participant). ### Columns | Column | Description | |--------|-------------| | **Participant** | Name (racer or challenger). Click to open their start list or challenge participant page. | | **Product** | Product title. | | **Variation** | Variation title if applicable. | | **Cart status** | Order status (e.g. New, Payment received). | | **Bought** | When the cart was created. | | **Price** | Final price paid. | ### Filters - **Search** – By product title or participant name/email. - **Event** – Limit to products of one event. - **Cart status** – Filter by order status. ### Export - **Export XLSX** – Exports the bought products list. The file is generated in the background and is available in **Documents**. --- ## Summary | Section | Purpose | |--------|--------| | **Products list** | View, filter, and export upsell products; create or edit a product. | | **Create/Edit product** | Define product type, pricing (single price, variations, or choices/stock), availability, and content. | | **Bought products** | See what was purchased, by whom, and when; filter and export. | --- # Virtual competition sport variants URL: /en/running-events/virtual-competition-sport-variants/ # Virtual competition sport variants Besides the default **5 km run** virtual race, the create wizard offers sport-specific **virtual competition** presets with preconfigured distance and allowed sports. **Path:** Manager console → **Create event** → competition type ## Run 5k (`run_com`) Default virtual run — 5000 m, run/orienteering/walk sports for step sync where applicable. ## Bike 20k (`bike_com`) | Setting | Default | |---------|---------| | Distance | 20 km | | Primary sport | Ride | | Allowed sports | Ride only | Participants need GPS-tracked cycling activities. See [Participate in virtual competitions](../joining-events/participate-in-virtual-competitions.md). ## Row / paddle 10k (`paddle_com`) | Setting | Default | |---------|---------| | Distance | 10 km | | Sports | Paddle, kayak, canoe | For rowing, kayaking, and canoeing virtual events. ## Ski 10k (`ski_com`) | Setting | Default | |---------|---------| | Distance | 10 km | | Sports | Ski, nordic ski | For cross-country ski virtual races. ## Defaults for all wizard competitions - Status: published but **unlisted** (private link) - Kind: challenge race (virtual timed format) - Free ticket created automatically - You are added as the first participant for testing Change distance, ticket price, and access in [Competition settings reference](competition-settings-reference.md) before going public. ## Related - [Create a virtual competition](create-a-virtual-competition.md) - [Create event wizard](create-event-wizard.md) - [Event types overview](event-types-overview.md) --- # Virtual competition start list URL: /en/running-events/virtual-competition-start-list/ # Virtual competition start list Virtual competitions use a specialized **start list** view linking each registration to submitted workouts. **Path:** Competition → **Start list** (virtual race) ## Differences from in-person | In-person | Virtual | |-----------|---------| | Bib numbers, wave, check-in | Workout submission status | | On-site payment | Online payment only (typically) | ## Participant status Columns show whether the racer submitted a qualifying GPS activity, distance completed, and validation state. ## Open virtual racer detail Click a participant to jump to [Managing individual racers](managing-individual-racers.md) with workout links — or use [Reviewing virtual workouts](reviewing-virtual-workouts.md) for bulk review. ## Related - [Create a virtual competition](create-a-virtual-competition.md) - [Participate in virtual competitions](../joining-events/participate-in-virtual-competitions.md) --- # Whitelabel and enterprise setup URL: /en/running-events/whitelabel-and-enterprise-setup/ # Whitelabel and enterprise setup Some clubs run DistantRace on a **whitelabel** deployment: a branded participant portal on a custom domain, connected to the same organizer console and event data on DistantRace. Whitelabel is a **platform-managed** offering. DistantRace enables the club flag, OAuth credentials, themed login pages, custom-domain hosting, and SAML identity providers. Organizers continue to create events and manage participants in the **manager console** as usual. Contact DistantRace support to discuss whitelabel for your organization. ## What whitelabel enables | Capability | Participant experience | Organizer / platform | |------------|------------------------|----------------------| | **Custom domain** | Browse and register at your club URL (e.g. `events.yourcompany.com`) | DNS + TLS provisioned by DistantRace; domain verified via [Embed domains](embed-domains-for-iframes.md) | | **Branded portal** | Club name, logo, colors, and localized UI chrome | SPA branding configured at deploy time; event content still comes from DistantRace | | **Themed login** | Login and account pages match your brand during OAuth | `domain_theme` templates on the DistantRace auth host | | **OAuth participant login** | Sign in on your portal; session persists in the browser | Authorization-code OAuth2 app scoped to your organization | | **Org API token** | Public listings (events, challenges, leaderboards) without login | Long-lived read token for the branded site backend | | **Hero images API** | Carousel banners on the portal home page | [Club branding and hero images](club-branding-and-hero-images.md) — available when `is_whitelabel` is enabled | | **SAML / enterprise SSO** | Sign in with work email via Microsoft Entra ID or other IdP | Per-domain IdP mapping; discovery at `/saml2/discovery/` — see [Enterprise SAML and whitelabel login](../joining-events/enterprise-saml-and-whitelabel-login.md) | | **Branded email** | Login codes and transactional mail from your sender | [SendGrid](../integrations/sendgrid.md) integration on the club | | **Join codes & invites** | Redeem codes and email invitation links on the branded site | Same join codes as distantrace.com; magic-link auto-enrol via API | | **Sport app connections** | Connect Garmin, Strava, step sources, etc. | OAuth connect flows run on the canonical DistantRace auth host, then return to your portal | | **REST API** | Full participant actions after login (join, sync workouts, profile) | Same `/api/v1/` surface as the mobile app — [Public API overview](../more-tools/public-api-overview.md) | | **Manager console** | N/A — organizers use distantrace.com | Unchanged; [Two-factor authentication](../joining-events/two-factor-authentication.md) still required | ::: note Platform vs. portal scope A whitelabel participant portal is a focused front end on top of the DistantRace API. Which screens are exposed (challenges only, competitions with checkout, team leaderboards, etc.) depends on the deployment. All underlying event types and settings are configured in the manager console. ::: ## How it fits together ```mermaid flowchart LR subgraph portal [Branded participant portal] SPA[Custom domain SPA] end subgraph drace [DistantRace platform] API["/api/v1/"] Auth[OAuth + themed login] Console[Manager console] SAML[SAML discovery] end SPA -->|org token — public data| API SPA -->|user token — after login| API SPA -->|redirect| Auth Auth --> SAML Console --> API ``` 1. **Participant portal** — a web app on your domain. It loads public event data with an organization-scoped API token and sends participants to DistantRace OAuth for login. 2. **DistantRace auth** — handles login codes, OAuth, SAML, and sport-app connections. Themed templates apply when the OAuth request includes your organization context. 3. **Manager console** — organizers create challenges, competitions, tickets, and marketing on distantrace.com. Changes appear on the branded portal through the API. ## Setup (platform-managed) DistantRace typically handles: | Item | Details | |------|---------| | `is_whitelabel` club flag | Unlocks hero-image management and the hero-images API | | OAuth applications | **User client** (authorization code) for participant login; **org token** for public listings | | `domain_theme` | Selects branded login/signup templates on the auth host | | Custom domain hosting | TLS certificate, ingress, and optional `*.wl.distantrace.com` staging hostname (matches your `domain_theme` slug) | | SAML identity providers | `SAMLIdentityProvider` records mapped to email domains | | Portal deployment | Branded SPA build, cache proxy, and CI/CD on the whitelabel infrastructure | ## What organizers configure themselves | Task | Where | |------|-------| | Events, tickets, join codes | Manager console — same as any club | | Hero images for the portal carousel | Marketing → **Hero images** (whitelabel clubs only) | | Embed / custom domains | Club → **Embed domains** — [Embed domains for iframes](embed-domains-for-iframes.md) | | Branded email sender | Club → Integrations → [SendGrid](../integrations/sendgrid.md) | | Club logo | Club → Settings | | Disable daily overview emails | Club-level or per-challenge setting (whitelabel clubs) | ## Participant login flows Whitelabel portals commonly use **OAuth authorization code**: 1. Participant clicks **Sign in** on the branded site. 2. Browser redirects to DistantRace `/oauth/authorize/` with your organization's UUID. 3. DistantRace shows a **themed** login page (email code, passkey, or SAML — depending on club configuration). 4. After authentication, the browser returns to your portal with a code exchanged for access and refresh tokens. 5. The portal calls `/api/v1/` with the user token for personal actions (join challenge, sync workouts, update profile). **Email invitation links** can auto-log participants in via the `redeem-email-token` API endpoint when the portal is configured with an org token. **SAML SSO** is available for enterprise clubs. Participants enter a work email; DistantRace routes to the correct IdP by domain. See [Enterprise SAML and whitelabel login](../joining-events/enterprise-saml-and-whitelabel-login.md). ## API credentials (overview) Whitelabel integrations use two credential types: | Credential | Grant / type | Typical use | |------------|--------------|-------------| | **Org token** | Long-lived bearer token (org admin user) | Public challenge/event listings, hero images, join-code validation, email-token redemption | | **User OAuth client** | Authorization code (+ refresh token) | Participant sign-in, join events, workouts, profile, checkout | Both are created and rotated by DistantRace during onboarding. Redirect URIs must match your portal's `/auth/callback` path on each environment (staging `*.wl.distantrace.com` and production custom domain). ### OAuth authorize URL Participant sign-in starts at `/oauth/authorize/` with: - `client_id` — your user OAuth application - `redirect_uri` — registered callback on your portal - `response_type=code` - `org=` — binds the login page to your organization and selects the themed template After the participant authenticates (email code, passkey, or SAML), DistantRace redirects to your callback with an authorization code. Exchange it server-side or in the SPA for access and refresh tokens. ### Join codes and invitation emails | Step | API | |------|-----| | Validate a code before showing checkout | `GET /api/v1/event/joincode/{code}/validate/` (org token) | | Redeem email magic link | `POST /api/v1/event/joincode/redeem-email-token/` with `{ "token": "…" }` | | Create codes from your back office | `POST /api/v1/event/joincode/` (admin user token — not the public org token) | Magic-link redemption can auto-create an account from join-code prefill data, return OAuth tokens, and auto-enrol the participant in a bound challenge when configured. Full endpoint map: [Public API overview](../more-tools/public-api-overview.md). ## Email and notifications When [SendGrid](../integrations/sendgrid.md) is connected: - **Login code** emails use your org's transactional template and sender address. - Registration and marketing templates follow the same integration. Whitelabel clubs can suppress the automated **Daily Overview** email for step challenges at the organization level (`daily_email_disabled`) or per challenge. ## Mobile app The standard **DistantRace mobile app** remains available. Participants can connect sport apps and sync steps through the app even when they register on a branded web portal. The app is not white-labeled; account data is shared across distantrace.com, the mobile app, and the branded portal. ## Organizer access Organizers and staff continue to use the **manager console** at distantrace.com: - URL pattern: `/console//` - [Two-factor authentication](../joining-events/two-factor-authentication.md) is required - SAML may be used for staff login on enterprise clubs, but console access is separate from the participant portal OAuth flow See [How to access the organizer console](access-the-organizer-console.md). ## Related - [Enterprise SAML and whitelabel login](../joining-events/enterprise-saml-and-whitelabel-login.md) — participant sign-in - [Club branding and hero images](club-branding-and-hero-images.md) - [Embed domains for iframes](embed-domains-for-iframes.md) - [Public API overview](../more-tools/public-api-overview.md) - [SendGrid](../integrations/sendgrid.md) --- # Sports activity challenges URL: /en/sports-activity-challenges/ # Sports activity challenges Overview of distance- and activity-based challenges. **Create, configure, and operate** sports challenges in [Running events](../running-events/index.md). ## In this section | Guide | What it covers | |-------|----------------| | [Introduction to sports activities](introduction-to-sports-activities.md) | Challenge types, scoring, and participant experience | ## Organizer setup (Running events) | Task | Guide | |------|-------| | Create a sports challenge | [Create a sports activity challenge](../running-events/create-a-sports-activity-challenge.md) | | CO₂, energy, team variants | [CO₂, energy, and team challenges](../running-events/co2-energy-and-team-challenges.md) | | Sports and scoring rules | [Challenge settings reference](../running-events/challenge-settings-reference.md) → Sports | | Activity limits | [Challenge rules and activity limits](../running-events/challenge-rules-and-activity-limits.md) | | Review workouts | [Managing challenge participants](../running-events/managing-challenge-participants.md) | | Per-participant edits | [Editing individual challenge participants](../running-events/editing-individual-challenge-participants.md) | ## Participant guides - [Participate in a challenge](../joining-events/participate-in-a-challenge.md) - [Why activities are missing](../joining-events/why-activities-are-missing.md) - [Supported apps](../connections-with-apps/supported-apps.md) Legacy `/en/books/sports-activity-challenges/` URLs redirect to Running events or Joining events. --- # Introduction to sports activities URL: /en/sports-activity-challenges/introduction-to-sports-activities/ # Introduction to sports activities Sports activity challenges are a type of challenge where you participate with sports activities — instead of daily steps, the participant is credited with the activities for which "start" / "stop" is pressed in one of the sports apps.