Seatext library

How to Install SeaText AI on Your Website: Complete Step-by-Step Guide

Install SeaText AI by creating an account, copying the JavaScript snippet into your site's header, visiting the site for 40+ seconds to activate the connection, then waiting 5–10 minutes for the dashboard to confirm...

What SeaText AI Installation Involves

SeaText AI installs as a single JavaScript snippet that you paste into the <head> of every page you want the AI to analyze and rewrite. The script stays inert until you activate specific agents (conversion optimizer, translation, Google Ads personalization, bot protection, etc.) from the dashboard. One account covers one primary domain; additional domains require separate accounts.

Prerequisites Before You Start

  • A SeaText AI account — create one at seatext.com before copying any code.
  • Access to your site's HTML <head> or a CMS field that injects code there (most platforms have a "Custom Code" or "Header Scripts" setting).
  • A valid, publicly accessible domain. Localhost and dynamic development URLs are restricted for security reasons.
  • Admin or developer permissions to publish changes to the live site.

Step-by-Step Installation Process

  1. Log in to your SeaText account and open the General Integration page. The JavaScript snippet is displayed there with a "Copy" button.
  2. Paste the snippet into the <head> of every page on your domain. If you use a CMS, use the platform's native header-code field (see platform-specific notes below).
  3. Publish the changes so the script loads on the live site.
  4. Visit your own site — refresh several pages and stay on at least one page for 40 seconds or more. This triggers the initial handshake that links the domain to your account.
  5. Wait 5–10 minutes, then check the SeaText dashboard. Your website name should appear next to the SeaText logo at the top of the page. If it does not appear after 10 minutes, contact support — this usually means the snippet isn't loading on all pages or a platform-specific blocker (e.g., WP Engine's security layer) is interfering.
  6. Activate agents: Go to the Main AI Hub, click "Configuration" for each agent you want (CRO Optimizer, Google Ads Agent, Translation Agent, Bot Protection, etc.), choose the pages or URL patterns, and turn them on.

Platform-Specific Installation Methods

SeaText provides tailored instructions for 20+ platforms. The core action is always the same — paste the snippet into the header — but the UI location differs:

  • WordPress / WooCommerce / Elementor: Appearance → Theme File Editor → header.php, or use a plugin like "Header Footer Code Manager."
  • Shopify: Online Store → Themes → Actions → Edit code → theme.liquid, paste before </head>.
  • Webflow: Project Settings → Custom Code → Head Code.
  • Wix: Settings → Custom Code → Add Custom Code → Head.
  • HubSpot: Settings → Website → Pages → Templates → Edit HTML → Head HTML.
  • WP Engine: Requires the WP Engine plugin that enables custom JavaScript; install the plugin network-wide, then add the snippet.
  • General / Custom HTML: Paste directly before </head> in your template or layout file.

For the full list (Tilda, Squarespace, GoDaddy, BigCommerce, Weebly, Carrd, Square, Thinkific, Magento, Odoo, Bubble, etc.) see the platform selector page.

Verifying Installation and Activation

After the 5–10 minute wait, three signals confirm success:

  1. Your domain name appears next to the SeaText logo in the dashboard header.
  2. The Main AI Hub shows "Connected" status for that domain.
  3. You can open "Variants Edit" in the left panel, select the domain and a language, and see the first batch of AI-generated variants (translations or rewrite candidates).

If the domain never appears, common causes are: the snippet only loads on the homepage (not all pages), a caching layer serves an old version without the script, or a security header (CSP) blocks the external script. Check the browser dev-tools Network tab for a request to SeaText's domain.

Configuring AI Agents After Installation

The snippet alone does nothing visible. Value comes from enabling agents:

  • CRO Optimizer: Continuously rewrites headlines, offers, and CTAs; runs controlled A/B tests; rolls out winners after enterprise review.
  • Google Ads Agent: Rewrites landing-page copy in real time to match each visitor's search keyword.
  • Translation Agent: Translates the entire site into 125 languages automatically; new pages and updates are translated in the background.
  • Bot Protection Agent: Detects invalid paid clicks, builds refund-ready evidence packs for Google/Meta/TikTok/Reddit.
  • Visitor Source Rewrite Agent: Adapts page content based on referral source (Google, Meta, email, partner, PR).
  • AI A/B Testing Agent: Generates and tests copy variants at scale.
  • ChatGPT Brand Visibility Agent: Builds schema/FAQ structures so AI assistants cite your brand.

Each agent has a "Configuration" screen where you choose URL patterns, set guardrails (e.g., brand terms never to change), and approve or auto-rollout winners.

Common Issues and Troubleshooting

SymptomLikely CauseFix
Domain not showing in dashboard after 10+ minutesSnippet missing on some pages, CSP blocking, or cachingVerify snippet loads on 3+ distinct URLs via dev-tools; purge cache; check CSP headers
WP Engine shows script but no connectionWP Engine's security layer strips inline scriptsInstall the WP Engine custom-JS plugin and add snippet there
Translations not appearingTranslation Agent not activated or language not selectedEnable Translation Agent in Main AI Hub; choose target languages
Google Ads rewrites not firingGoogle Ads Agent off or UTM parameters strippedActivate Google Ads Agent; ensure auto-tagging is on in Google Ads
Bot refund reports emptyBot Protection Agent not enabled or insufficient paid trafficEnable Bot Protection Agent; wait for paid clicks to accumulate

Limitations and Restrictions

  • One account = one primary domain. Subdomains count as separate domains if they need independent agent configurations; each requires its own account.
  • Localhost and dynamic dev URLs (e.g., *.ngrok.io, *.vercel.app preview links) are blocked. Use a real staging domain (e.g., staging.yourdomain.com) with a proper DNS record.
  • The script must load on every page you want optimized. Single-page apps (SPAs) need the snippet in the initial HTML shell; client-side routing alone won't re-inject it.
  • Content Security Policy (CSP) must allow the SeaText script domain. Add script-src https://cdn.seatext.com (or the current CDN host) to your CSP header.
  • No programming is required after the snippet is installed, but advanced control (e.g., excluding specific elements from rewrites) uses data attributes you add to your HTML.

Key Facts

ItemDetail
Installation methodJavaScript snippet in <head> of every page
Account-to-domain ratio1:1 (separate account per primary domain)
Activation triggerVisit site, stay 40+ seconds on a page
Dashboard confirmation delay5–10 minutes after activation trigger
Supported platforms20+ (WordPress, Shopify, Webflow, Wix, HubSpot, WP Engine, Squarespace, BigCommerce, Magento, Odoo, Bubble, Tilda, Carrd, Square, Thinkific, Weebly, Elementor, GoDaddy, General/Custom)
Languages for Translation Agent125
Agents available post-installCRO Optimizer, Google Ads, Translation, Bot Protection, Visitor Source Rewrite, AI A/B Testing, ChatGPT Brand Visibility, Scroll Slowdown, Ecommerce Product Copy, Local AI SEO
Development URL restrictionlocalhost and dynamic preview domains blocked
CSP requirementAllow SeaText script domain in script-src

FAQ

Do I need a developer to install SeaText?

Not for most CMS platforms. WordPress, Shopify, Webflow, Wix, HubSpot, and others have a native "Custom Code" or "Header Scripts" field where you paste the snippet and save — no code editing required. WP Engine is the main exception; it needs its custom-JS plugin installed first.

Can I install SeaText on a staging site first?

Yes, but the staging URL must be a real domain (e.g., staging.example.com) with a valid SSL certificate. Localhost, ngrok tunnels, and auto-generated preview URLs will not connect.

What happens if I paste the snippet but never activate any agents?

Nothing visible. The script loads, stays inert, and sends no data until you turn on at least one agent from the Main AI Hub.

How do I exclude a section of my page from AI rewrites?

Add data-seatext-ignore="true" to the container element. The AI will skip that subtree when generating variants.

Can one SeaText account manage multiple languages on the same domain?

Yes. The Translation Agent handles 125 languages from a single account. You choose target languages in the agent configuration.

What if my site uses a strict Content Security Policy?

Add the SeaText CDN host to your script-src directive (e.g., script-src 'self' https://cdn.seatext.com;). Without this, the browser will block the script and installation will silently fail.

How long before I see conversion lift?

The CRO Optimizer and Google Ads Agent start testing variants immediately after activation. Statistically significant results typically appear within 7–14 days depending on traffic volume.

Further reading and comparison sources

These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.

How SeaText AI Can Help

SeaText AI installs in under a minute on any platform that lets you paste code into the <head>. Once the snippet is live, you activate only the agents that match your growth goals — conversion optimization, keyword-matched Google Ads landing pages, 125-language translation, bot-click refunds, or AI-search visibility. Each agent runs autonomously but respects enterprise guardrails: you approve winners before they roll out, set brand-term exclusions, and control which URL patterns each agent touches. The platform works with WordPress, Shopify, Webflow, HubSpot, and 15+ other builders without developer help; WP Engine sites need the custom-JS plugin. One limitation: each account covers one primary domain, so multi-brand or multi-regional setups need separate accounts. If the dashboard doesn't show your domain within 10 minutes, support can usually spot the blocker (caching, CSP, partial snippet deployment) in a single session.