Add your Tymeslot booking page to WordPress with the official plugin — a Gutenberg block, a shortcode, or a floating button. No HTML to paste, and no drift from your dashboard settings.
The Tymeslot plugin is open source. Until it lands in the WordPress.org directory you can
install it straight from GitHub — download the latest release zip, then upload it in your
WordPress admin.
In WordPress, go to Plugins → Add New Plugin → Upload Plugin, choose the
zip, and click Install Now.
Click Activate. A new Tymeslot
menu appears in your admin sidebar.
2
Connect your account
Open Tymeslot → Setup and choose where your account lives:
Cloud— the default. Nothing to configure; you are already pointed at tymeslot.app.
Self-hosted— pick this and enter your own instance URL (e.g. https://book.example.com). You can switch back to Cloud at any time.
Then set your booking username — the handle in your booking URL,
e.g. tymeslot.app/your-handle.
Every block and shortcode inherits this unless you override it.
3
Allow your site to embed
This step is required, or the booker stays blank
For security, Tymeslot only lets your booking page be framed on domains you approve. In your
Tymeslot dashboard open Embed → Security
and add your WordPress site's domain
to the allowed embed domains, then save.
The Setup tab includes a live embedding status check: it loads your real
booking page from inside WordPress and tells you, right in the browser, whether this site is
allow-listed yet — so you never have to guess.
4
Add a booking page
Three ways, all driven by the same engine:
Block
In the editor, insert the Tymeslot Booking block and configure it in the
sidebar — mode (inline, popup, floating, or link), theme, layout, language, and size. The
canvas shows a branded placeholder; your booking page renders on the published page.
Shortcode
Drop the shortcode into any post, page, or widget:
Prefer to paste a snippet into a page builder or custom theme?
Tymeslot → Embed generator
builds the same code with a live preview and a one-click copy — identical to the snippet your
Tymeslot dashboard produces.
🎨
Customise the look
Choose a theme
(Quill or Rhythm), a layout
(column for a wide
canvas, or default for a centred card), and a language. Set defaults once on
the Setup tab, or override them per block and shortcode.
Your brand colour comes from your account
The booker's accent colour is the palette you choose in your Tymeslot account, and it carries
into every embed automatically — there's nothing to set in WordPress.
🛠️
Troubleshooting
The booker shows a short "unavailable" message:
your site's domain isn't allow-listed yet. Add it under
Embed → Security
(the plugin deliberately shows a clear message rather than letting the Tymeslot homepage
render inside your page). Re-check on the Setup tab.
Strict Content-Security-Policy:
the inline and link modes work under a strict CSP; popup and floating use a small inline
script, so they need
'unsafe-inline'
in your
script-src
(or a nonce/hash).
Caching plugins:clear your cache after adding a block or shortcode so the embed script loads.
Embedding elsewhere
Not on WordPress, or want the raw snippets for any platform? See the
Widget Embedding
guide, which covers Webflow, Wix, Squarespace, Shopify, and custom HTML.
Embed the Tymeslot booking widget as an inline section, popup, or floating button. Works with WordPress, Webflow, Wix, Squarespace, Shopify, and custom HTML.
