SummitGPX Docs

Embeds

Embeds provide runners with access to route information without leaving your event website, helping create a seamless experience while ensuring route data remains synchronised with SummitGPX.

What are Embeds?

An embed is a version of your SummitGPX route that can be displayed within another website.

Embedded routes can include:

  • Interactive route maps
  • Elevation profiles
  • Route statistics
  • Checkpoints
  • GPX downloads

Changes made within SummitGPX are reflected automatically in the embedded route.

Why Use Embeds?

Embedding routes on your website allows you to:

  • Keep runners on your own website
  • Avoid maintaining route information in multiple places
  • Ensure route information stays up to date
  • Provide an interactive experience for runners
  • Reduce administration when routes change

Creating an Embed

To create an embed:

  1. Open the route you wish to embed.
  2. Navigate to the Embed section.
  3. Copy the embed code provided by SummitGPX.
  4. Paste the code into your website.

Once published, the route will appear directly on the page.

Adding an Embed to Your Website

The embed code can be added to most modern website platforms, including:

  • Custom websites
  • WordPress
  • Squarespace
  • Wix
  • Webflow
  • Event websites

If your website supports HTML embeds or iframe content, SummitGPX embeds can usually be added without additional configuration.

Responsive Design

SummitGPX embeds are designed to work across a wide range of devices.

Embedded routes automatically adapt to:

  • Desktop computers
  • Laptops
  • Tablets
  • Mobile phones

This ensures runners can access route information wherever they are.

What Happens When a Route Changes?

One of the biggest benefits of SummitGPX embeds is that they update automatically.

When a new route version is uploaded:

  • The embedded route updates automatically
  • Route statistics are recalculated
  • Elevation profiles are regenerated
  • Checkpoint information is updated

There is no need to replace the embed code or update your website.

GPX Downloads

Embedded routes can provide runners with access to GPX downloads directly from your website.

This means runners can:

  • View the route
  • Explore the elevation profile
  • Download the latest GPX file

all from a single location.

Best Practice

For the best experience:

  • Place route embeds on your event route page
  • Include supporting route information nearby
  • Test the embed on desktop and mobile devices
  • Review the embedded route after making route updates

This helps ensure runners always have access to accurate route information.

Troubleshooting

The embed is not displaying

Check that:

  • The embed code has been copied correctly
  • Your website allows embedded content
  • No part of the code has been modified

The route looks out of date

Embeds automatically display the latest route version.

If changes are not visible, confirm that the updated route has been processed successfully within SummitGPX.

The embed is too small

Adjust the size of the container on your website to provide more space for the route map and elevation profile.

Frequently Asked Questions

Do I need to update the embed code when a route changes?

No. The embed code remains the same and automatically displays the latest route version.

Can I use the same embed on multiple pages?

Yes. The same embed code can be used wherever you want the route to appear.

Do embeds work on mobile devices?

Yes. SummitGPX embeds are responsive and designed to work across desktop, tablet and mobile devices.