# Install on WordPress

> Add Kymo to a WordPress site via a header snippet plugin, a block theme, or a classic theme's header.php.

Canonical: https://kymo.in/docs/guides/wordpress
Last updated: 2026-07-21

Pick whichever matches how your site is built. All three put the same tag in the page `<head>`.

## Option 1: a header-snippet plugin (simplest)

Install a plugin such as "WPCode" or "Insert Headers and Footers". In its Header section, paste:

```html
<script defer src="https://kymo.in/beat.js" data-site="yoursite.com"></script>
```

Save. This applies site-wide with no theme edits.

## Option 2: a block theme

In the admin, go to Appearance, then Editor, then Patterns or the template's header, and add a Custom HTML block containing the tag. Block themes vary — the header-snippet plugin is more reliable if you are unsure.

## Option 3: a classic theme

Edit your theme's `header.php` and paste the tag immediately before `</head>`. Use a child theme so a theme update does not overwrite it.

> **Note:** Some caching and "optimization" plugins defer, combine, or delay third-party scripts. If events do not arrive, exclude `beat.js` from script optimization in your caching plugin, then re-test.

Then [verify events arrive](https://kymo.in/docs/start/verify).