For webmasters
Festival widget for your website
Show your visitors the next festivals, filtered by country, genre, region or radius. The list updates itself, so you never have to copy a date again. Free, with no cookies and no tracking.
The only thing we ask: the small “Powered by festivalbeats.de” link stays visible.
1. Configure your widget
2. Preview
This is exactly how the widget appears on your site, with live data.
3. Copy and paste the code
Paste the code into your HTML where the widget should appear. Works in WordPress (“Custom HTML” block), Jimdo, Wix, Webflow and any other system that allows custom HTML.
All parameters
For hand-editing: every setting is a data attribute on the widget element. Several widgets per page are fine.
| Attribute | Values |
|---|---|
| data-layout | cards for festival cards, otherwise compact list |
| data-background | Cards only: hex colour such as #0b0b13, transparent if omitted |
| data-country | ISO country code, e.g. DE. Several separated by commas, e.g. DE,AT,CH,LU |
| data-category | electronic, 90s, 2000s, mixed . Several separated by commas, e.g. 90s,2000s |
| data-region | Region name, e.g. Saarland |
| data-search | Free text: festival, city, genre or artist |
| data-place | Town or postcode for the radius search |
| data-radius | 25, 50, 100, 200, 300 (km) |
| data-period | this_weekend, next_weekend, 30_days |
| data-limit | 1 to 24 (default 5) |
| data-lang | de, en |
| data-theme | light (otherwise dark); for cards: text colour of heading and links, otherwise automatic |
| data-title | Custom heading, empty = no heading |
| data-images | true shows thumbnails in the list |
| data-target | self opens links in the same tab |
Good to know
- What does it cost?
- Nothing. We only ask that the visible “Powered by festivalbeats.de” link stays in place. Please do not remove or hide it.
- Will it clash with my design?
- The widget ships its own isolated styles (Shadow DOM). Your CSS stays untouched and vice versa. It adapts to the available width: cards sit side by side as many as fit and stack on phones.
- How fresh is the data?
- Only approved, upcoming festivals appear. New dates, cancellations and postponements show up within a few minutes.
- Privacy
- The widget sets no cookies and contains no tracking. When it loads, your visitors’ browsers fetch the script, festival data and, if enabled, images from festivalbeats.de; our server necessarily processes the IP address for this (see our privacy policy). We recommend mentioning the embed in your own privacy policy.
- Missing a festival?
- Submit it and, once checked, it appears in your widget automatically.