Drop-in embeds
Load Haven via the Kit CDN or standalone assets, then render into any container on your page.
Haven IntegrationEmbed Directory & Calendar
Client documentation for adding Haven listings and events to any website.
Skip to content
What is Haven?
Haven is a destinations platform that powers business directories and event calendars. The Haven JavaScript library (haven-js) lets you embed those experiences directly on your website without a CMS plugin.
This documentation covers standalone HTML/JavaScript integration — the pattern used when you control the page markup and script tags.
Supported modules
| Module | Purpose | Common formats |
|---|---|---|
| Directory | Business and attraction listings | list, itinerary, category-list, detail |
| Calendar | Events and happenings | list, daily, upcoming, ongoing |
What you need
Before integrating, obtain from your Haven account:
- Haven Kit URL — a single script that loads the library and your feed credentials
- Mapbox access token (optional) — required when maps are enabled
- Font Awesome kit (optional) — for search and filter icons
See Prerequisites for the full checklist.
Browser support
Haven targets modern browsers (Chrome, Firefox, Safari, Edge). Internet Explorer is not supported.
Sample integration
A full working demo is available in the Haven sample integration project. Use it as a reference when building your own pages — the examples in this documentation use generic placeholders so they work for any client.