Connecting a WordPress site
Install the Threadliner WordPress plugin and embed your first form or newsletter signup.
The WordPress plugin embeds live Threadliner forms and newsletter signups on any page or post via Gutenberg blocks — submissions go straight from the visitor's browser to your Threadliner account.
The plugin's own screens still say "Threadline" (its settings page, its two block names) rather than "Threadliner" — a naming cleanup that hasn't shipped yet. It's the same plugin; just expect the older name inside WordPress itself until that's updated.
Requirements
- WordPress 6.4 or later
- PHP 8.0 or later
Steps
- Install and activate the plugin on your WordPress site.
- In Threadliner, go to Settings → API Keys, create a key, and copy it — it starts
with
tl_live_and is only shown once. - In WordPress, go to Settings → Threadline.
- Enter:
- API URL — your Threadliner API endpoint (e.g.
https://api.threadliner.io). - API Key — the key from step 2.
- API URL — your Threadliner API endpoint (e.g.
- Click Save & Test Connection. You'll see "Connected to Threadline." if it worked, or an error message describing what failed.
- Edit any page or post, add a block, and search for "Threadline Form" or "Threadline Newsletter Signup". Pick which form or list it should embed from the block's sidebar panel.
If the connection test fails
The plugin checks the API URL and key are both filled in before it will even attempt a request — if either is empty, you'll see "Threadline is not configured." rather than a network error. Otherwise, the error message includes the HTTP status Threadliner's API returned, which is usually enough to tell what's wrong (401 → the key is invalid or was revoked; a connection timeout → the API URL is wrong or unreachable from your server).
Last updated on