Back to Overview

WordPress Plugin

Add your Tymeslot booking page to WordPress with the official plugin, as a Gutenberg block, a shortcode or a floating button. There is no HTML to paste, and the plugin produces the same embed code as your dashboard.

Luka Breitig, Software Engineer & AI Developer
Luka Breitig

Zaktualizowano: 30 czerwca 2026

Get the plugin

The Tymeslot plugin is free, open source and listed in the official WordPress.org plugin directory. Install it from your WordPress admin, or get the source on GitHub.

The Tymeslot embed generator inside the WordPress admin, with a live preview of the booking page
The Tymeslot embed generator in the WordPress admin: pick a mode, theme and layout, then add the block or shortcode to any page.

1 Install the plugin

  1. In WordPress, go to Plugins → Add New Plugin and search for Tymeslot.
  2. Click Install Now, then Activate. A new Tymeslot menu appears in your admin sidebar.

Prefer a manual install? Download tymeslot.zip from the WordPress.org listing (or a tagged build from GitHub releases ) and upload it under Plugins → Add New Plugin → Upload Plugin.

2 Connect your account

Open Tymeslot → Setup and choose where your account lives:

  • Cloud is the default, with nothing to configure: the plugin already points at tymeslot.app.
  • Self-hosted asks for 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

Tymeslot only shows your booking page inside other websites on domains you approve. In your Tymeslot dashboard, open Embed & Share → Security, enter your WordPress site's domain under Add Allowed Domain and click Add Domain.

The plugin's Setup tab has a live embedding status check: it loads your real booking page from inside WordPress and tells you whether this site is allow-listed yet.

4 Add a booking page

There are three ways, and all produce the same embed:

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 editor shows a placeholder; your booking page appears on the published page.

Shortcode

Add the shortcode to any post, page or widget:

[tymeslot username="your-handle" mode="inline"]

Supported attributes: username, mode (inline / popup / floating / link), theme, layout, locale, height, width, and label.

Embed generator

Prefer to paste a snippet into a page builder or custom theme? Tymeslot → Embed generator builds the same snippet your Tymeslot dashboard produces, with a live preview and a copy button.

🎨 Customise the look

Choose a theme (the design of your booking page), 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, so 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 & Share → 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.

🔗 Related Articles

Read Widget Embedding

Widget Embedding

Embed the Tymeslot booking widget as an inline section, popup, or floating button. Works with WordPress, Webflow, Wix, Squarespace, Shopify, and custom HTML.