Before you start
- Create or open your widget in Text.st under Website Widgets.
- Copy the exact install snippet shown for that widget, because it identifies your widget.
- Make sure you can edit the site footer or a Custom HTML block on your WordPress site.
Snippet example
Your snippet loads the Text.st widget from https://app.text.st/api/public/widget/loader.js and carries your widget key. The full snippet looks like this:
<script async src="https://app.text.st/api/public/widget/loader.js" data-textst-key="YOUR_WIDGET_KEY"></script>When you click Copy Code in your Text.st dashboard under Widgets → Installation, YOUR_WIDGET_KEY is automatically replaced with your workspace's actual 24-character key.
Always paste the full snippet copied from Text.st rather than this example, so your widget settings are included.
Install on WordPress
Some security or optimization plugins delay or combine scripts. If the widget does not appear, exclude the Text.st loader from script delay and minify settings.
- Step 1: Sign in to your WordPress admin area.
- Step 2: For a single page, edit the page and add a Custom HTML block where the widget should load.
- Step 3: For every page, open Appearance, then Theme File Editor or your theme footer settings, or use a trusted header and footer code plugin.
- Step 4: Paste your Text.st snippet just before the closing body tag or inside the Custom HTML block.
- Step 5: Save or update the page, then clear any caching plugin so visitors receive the new version.
Test after publishing
- Open the live published page in a private or incognito window.
- Refresh the page and wait a few seconds for the widget to appear.
- Open the widget and submit a test request with your own phone number.
- Check the Lead Inbox in Text.st to confirm the request arrived.
- Test on a phone as well as a computer.
Troubleshooting
- Widget not showing: confirm the site was published and clear any site or browser cache.
- Still missing: confirm the snippet is complete and was not changed by an editor or plugin.
- Shows twice: remove duplicate copies of the snippet from other pages or settings.
- Works in some places only: check whether the code was added to all pages or a single page.
- Request not in the Lead Inbox: confirm you copied the snippet from the correct widget and workspace.
- Live texts not sent: messaging approval and activation are required before live messages can be sent.
Related guides
What Text.st website widgets doUnderstand how a Website Widget collects a visitor request and begins a consent based text conversation.Add your Text.st widget to ShopifyInstall the Text.st Website Widget on Shopify using the theme layout file, then test it on your live site.Add your Text.st widget to WixInstall the Text.st Website Widget on Wix using Custom Code in site settings, then test it on your live site.
