golfbox Embedded Solution
Integration guide – competition data on your own website
Overview
The golfbox embedded solution lets you show live competition data from golfbox directly on your own website – competition calendars, start lists, live leaderboards, results and Order of Merit rankings. Each view is added with a single line of code, and the content updates automatically. You never need to maintain the data on your website; everything is driven directly from golfbox.
How to embed a view
Your webmaster simply pastes a script tag into the page, at the position where the content should appear. For example, the competition calendar:
<script src="https://scores.golfbox.dk/api/js/schedule/customerid/{CustomerID}/language/2057/template/GolfBox" type="text/javascript"></script>
The exact script – including the correct server address and your IDs – is generated for you in golfbox (see Getting the script from golfbox below), so you never need to build the URL by hand.
The content renders directly in your page at that position – no iframe required – and inherits the width of the surrounding container, so it fits naturally into your existing layout.
The script URL explained
https://scores.golfbox.dk/api/js/{view}/{identifier}/{id}/language/{code}/template/{template}
| Parameter | Meaning |
|---|---|
| view | The view to display: schedule, orderofmerits, leaderboard, holebyhole, result, teetimes, players, info or orderofmerit. See the full list under Available views. |
| customerid / competitionid | Which data to show. Customer-level views use your customerid. Competition views use the competitionid of the individual competition. Both are filled in automatically when the script is generated in golfbox. |
| language | Display language, given as a standard language code (LCID) — for example 2057 = English, 1030 = Danish, 1034 = Spanish. Can be set per embed. |
| template | The visual design. GolfBox is the standard design. Custom templates styled to match your website can be created for you — see Design and colour customization below. |
| hideNavigation | Optional. true hides the top navigation bar and the top header (e.g. customer name and competition name). Default: false. |
| hideTopBar | Optional. true hides only the top navigation bar. Default: false. |
The optional parameters are simply appended to the URL. For example, a leaderboard without the navigation bar and header:
<script src="https://scores.golfbox.dk/api/js/leaderboard/competitionid/{CompetitionID}/language/2057/template/GolfBox/hideNavigation/true" type="text/javascript"></script>
Available views
| View | Script name | Identifier used | Description |
|---|---|---|---|
| Competition calendar | schedule | customerid | Full calendar of your competitions, always up to date. |
| Orders of Merit | orderofmerits | customerid | Overview of all your Order of Merit rankings. |
| Leaderboard | leaderboard | competitionid | Live leaderboard for a specific competition. |
| Hole-by-Hole leaderboard | holebyhole | competitionid | Live leaderboard with hole-by-hole scores. |
| Result list | result | competitionid | Final results for a specific competition. |
| Start list | teetimes | competitionid | Starting times and groups for a specific competition. |
| Entry list | players | competitionid | List of entered players for a specific competition. |
| Information | info | competitionid | General information page for a specific competition. |
| Order of Merit | orderofmerit | orderofmeritid | Standings for a specific Order of Merit. |
Deep links: filtering the calendar by season and category
The calendar view supports deep links, so you can link directly to a filtered view of the calendar – for example only competitions in a specific category for a specific season. The link is added after the page URL as a hash route:
#/customer/{CustomerID}/schedule/{Season}/{CategoryID}
Example – link directly to one category for the 2026 season:
https://www.yourwebsite.com/competitions/#/customer/{CustomerID}/schedule/2026/{CategoryID}
The CategoryID values are specific to your setup – contact golfbox support to get the list of your categories.
Please note: if your available categories change in the future, the CategoryID references in your deep links may need to be updated.
Getting the script from golfbox
golfbox generates the correct script for every view:
- In golfbox, open the competition and go to Settings → Embedding.
- Select the view you want (Leaderboard, Result list, Start list, Entry list, Information, etc.).
- Copy the generated script tag and paste it into your web page.
The Embedding settings also let you control what is shown in the calendar view, for example whether venue, start time or competition type are displayed.
Design and colour customization
All views come with the standard GolfBox template. If you would like the embedded views to match the look of your website, we can create a custom template for you. All views using the template share the same styling, so the integration looks consistent across your site.
To get a custom template, or to adjust an existing one, send us:
- Your brand colours (hex codes) for backgrounds, headers, text and highlights.
- Your preferred font, if it differs from the standard one.
- A link to the page(s) where the views will be embedded, so we can check the result in context.
Template changes are made centrally by us – once updated, every page using the template is updated automatically, with no changes needed on your website.
Good to know
- The scripts are served over HTTPS and work on any modern website platform (WordPress, custom CMS, etc.).
- You can embed several views on the same site – for example the calendar on one page and a live leaderboard on a competition page.
- The language parameter can be changed per embed if you need the same view in more than one language.
- Live views (leaderboards) update automatically while scoring is in progress.
Questions?
If you need help with the integration, want additional views embedded, or would like a custom template, contact golfbox support and we will set it up together with you.
Comments
0 comments
Please sign in to leave a comment.