Embeds

Embeds are Pro features that let you place an interactive SummitGPX route on your own event website. The embedded route stays connected to SummitGPX, so route updates appear without changing the embed code.

Marketing pages describe this as keeping every embed, link and QR code up to date after a route change. In the app, embeds remain available only for public routes on accounts with embed access.

Before embedding a route, complete the Typical Organiser Workflow and review the GPX Health Check workflow for the file runners will download.

What Embeds Include

Embedded routes can show:

• Interactive map.
• Elevation profile.
• Route statistics.
• Checkpoints where configured.
• Download buttons for supported formats.
• Route playback on Pro routes.

Creating an Embed

1. Open the route you want to embed.
2. Choose the embed or sharing controls.
3. Select the size, layout and alignment that suit your website.
4. Copy the embed code.
5. Paste it into your website where HTML embeds are supported.

Embeds support compact, standard and full sizes, sidebar or bottom layouts and left, centre or right alignment.

Private Routes

Private routes cannot be shown publicly in embeds. If an embedded route is private or the account does not have embed access, visitors see an access message instead of the route.

Downloads Inside Embeds

Embeds can include the same current route downloads as the hosted route page, depending on the account plan and route configuration. This can include GPX, KML, TCX, FIT, Distance & Ascent Table PDF/CSV and split GPX downloads. The PDF and CSV files follow the visitor's current distance and elevation selections.

See Downloads and Exports for format availability, GPS/watch points and split routes.

Distance and Elevation Units

If Allow runners to choose units is enabled in the route’s Share and embed panel, an embed shows separate controls for distance and elevation. Visitors can choose kilometres or miles independently from metres or feet, and SummitGPX remembers the choices in that browser where possible.

If the setting is disabled, the embed follows the organiser’s saved route default and does not show the runner controls. See Distance and Elevation Units.

Branding

Pro accounts can customise embedded route branding from account settings. Options include logo upload, colour theme, accent colour, button style and whether SummitGPX footer branding is shown.

You can also upload a Browser Tab Icon in PNG, SVG, ICO or JPG/JPEG format. It is used on branded hosted route pages and embeds, and when a runner saves the page to a phone or tablet home screen.

Analytics

Pro account analytics include embed views. This helps organisers see whether runners are using routes through the event website as well as the hosted SummitGPX route page.

What Happens When a Route Changes?

When a route is edited, replaced or restored, the embed displays the latest route once processing is complete. Existing embed code continues to work.

Troubleshooting

The Embed Is Not Displaying

Check that the code was copied completely, your website allows HTML embeds or iframes and the route is public.

The Route Looks Out of Date

Confirm the route update has finished processing in SummitGPX. Embeds use the latest processed route version.

The Embed Is Too Small

Choose a larger embed size or give the embed container more space on your website.

Best Practice

• Place route embeds on the same page as your event route notes.
• Test the embed on desktop and mobile after publishing.
• Use Pro branding settings when the route needs to match your event website.
• Review embeds after route updates, checkpoint changes and version restores.
• After significant route changes, re-run Health Check on the latest GPX before asking runners to download again.