Skip to content
Sam Docs

Install Sam on WordPress

This guide walks you through installing Sam on a WordPress site using our official plugin. Total time: about 2 minutes.

Who this is for

You run a WordPress site (self-hosted or WordPress.com Business+) and you have admin access.

Prerequisites

  • WordPress 5.8 or newer
  • PHP 7.4 or newer
  • Admin access to your site (you can install plugins)
  • A Sam account at viasam.app — free trial available
  • Your Sam API token (see Find your API token below)

Step 1 — Download the Sam plugin

Download the latest plugin .zip:

https://viasam.app/install/wordpress/sam-widget.zip

Step 2 — Upload to WordPress

  1. In your WordPress admin go to Plugins → Add New → Upload Plugin.
  2. Choose the .zip you downloaded.
  3. Click Install Now.
  4. Click Activate Plugin.

Step 3 — Paste your API token

  1. Go to Settings → Sam Widget in your WordPress admin.
  2. Paste your API token in the input field.
  3. Click Save changes.

You’ll see ”✓ Widget is active on your site.” once saved.

Step 4 — Verify

Open your site’s homepage in a new tab. The Sam widget should appear in the corner you configured (default: bottom-right).

If you don’t see it, return to your Sam dashboard, open the widget you installed, click Install your widget → Verify, and paste your homepage URL. Sam will tell you what’s wrong.

Find your API token

  1. Sign in to viasam.app.
  2. Go to Widgets in the sidebar.
  3. Click the widget you want to install.
  4. In the Install your widget card, your API token is shown (or pre-filled in the snippet).

Troubleshooting

Widget doesn’t appear. Clear your site’s cache (and CDN cache if you have one). Some caching plugins serve stale HTML for hours.

“Invalid API token” error. Tokens are 40 alphanumeric characters. Make sure you copied the whole thing without extra spaces.

Widget appears in admin too. It shouldn’t — the plugin is configured to skip admin pages. If you see it inside wp-admin, contact support.

Updating the plugin. When we release a new version, WordPress will show an update notification on your Plugins page just like any other plugin. The plugin auto-checks our update server once a day.

Privacy & data

The plugin loads a single JavaScript file (widget.js) from cdn.viasam.app on every page of your site. The widget itself sends visitor messages to the Sam API for AI responses. See the Sam privacy policy for details.

Need help?

Email support@viasam.app — include your domain and the widget name.