Seatext library

How to Check WP Engine Compatibility with SeaText: A Readiness Checklist

Before installing SeaText on WP Engine, verify your PHP version (7.4+), WordPress version (5.8+), and install the WP Engine plugin that allows custom JavaScript. You also need a SeaText AI account linked to a...

To check if your WP Engine installation is compatible with SeaText, confirm three things: your server runs PHP 7.4 or higher, WordPress is 5.8 or newer, and you have installed the WP Engine plugin that enables custom JavaScript injection across all pages. You also need an active SeaText AI account tied to a real production domain — development URLs like localhost or dynamic staging domains will not work.

SeaText System Requirements at a Glance

SeaText runs as a JavaScript snippet that you paste into your site. The snippet is inert until activated, so it will not break your existing content. The platform requires a modern PHP environment because the WordPress admin and any server-side helpers rely on current language features. WP Engine typically provides PHP 8.0+ on current plans, but older legacy containers may still run PHP 7.3 or earlier. Check your PHP version in the WP Engine dashboard under Sites > Environment > PHP version. If you see 7.3 or below, request an upgrade from WP Engine support before proceeding.

WordPress core must be 5.8 or higher. This ensures the block editor and REST API endpoints SeaText may use are available. Update WordPress from the dashboard if needed. No special PHP extensions beyond the standard WP Engine stack (cURL, mbstring, OpenSSL, JSON) are required, but confirm they are enabled — WP Engine includes them by default.

WP Engine Specific Requirement: Custom JavaScript Plugin

WP Engine blocks direct theme file edits and some header/footer injection methods for security. SeaText documentation explicitly states: "If you are using WPEngine please download the WP Engine plugin that enables you to add custom JavaScript code to your pages. Install it and apply it across all your pages." This plugin is the only supported way to inject the SeaText snippet site-wide on WP Engine. Without it, the script will not load on every page, and the AI activation handshake will fail.

Install the plugin from the WP Engine plugin repository or via SFTP. After activation, locate its settings (usually under Settings > WP Engine Custom JS or similar), paste the SeaText JavaScript code provided in your account, and save. Ensure the option to apply the code to all pages is selected.

Account and Domain Prerequisites

You must have a SeaText AI account before installation. Each account is linked to a single primary URL. If you run multiple domains — for example, a staging site and a production site — you need a separate SeaText account for each domain. Development URLs such as localhost, *.local, or dynamic preview domains (e.g., pr-123.example.com) are restricted for security reasons and will not reliably associate traffic with your account. Use a real, publicly resolvable domain for each account.

If you manage several websites, create one SeaText account per website. The platform does not support multi-site installations under a single account.

Step-by-Step Readiness Checklist

  1. Verify PHP version: WP Engine dashboard > Environment > PHP version ≥ 7.4 (8.0+ recommended).
  2. Verify WordPress version: Dashboard > Updates > WordPress ≥ 5.8.
  3. Confirm required PHP extensions: cURL, mbstring, OpenSSL, JSON (standard on WP Engine).
  4. Install WP Engine Custom JavaScript plugin: Add and activate the plugin that allows site-wide JS injection.
  5. Create SeaText AI account: Register at SeaText using your production domain.
  6. Obtain JavaScript snippet: Copy the code from your SeaText account dashboard.
  7. Paste snippet into WP Engine plugin settings: Apply to all pages.
  8. Clear WP Engine caches: Purge all caches from the WP Engine dashboard or via the admin bar.
  9. Visit your site multiple times: Stay on a page for at least 40 seconds to trigger AI activation.
  10. Wait 5–10 minutes: Check the SeaText dashboard — your site name should appear next to the SeaText logo.

Verification: How to Know It’s Working

After completing the checklist, the SeaText dashboard is your source of truth. The documentation says: "Wait at least five minutes until you see your website name displayed next to the SEATEXT logo at the top of this page. This indicates that your website is connected and ready to proceed." If the site name does not appear after 10 minutes, contact SeaText support — this usually means the snippet is not loading (plugin misconfiguration), the domain does not match the account, or a cache layer is serving stale HTML.

You can also open your browser’s developer tools (Network tab), filter for seatext, and confirm the script loads with a 200 status on every page type (home, single post, archive, checkout).

Common Compatibility Pitfalls

  • Using a staging domain with the production SeaText account: Each domain needs its own account.
  • Skipping the WP Engine Custom JS plugin: The snippet won’t load site-wide.
  • Not clearing WP Engine cache after pasting the snippet: Visitors see cached pages without the script.
  • PHP version below 7.4: May cause admin errors or REST API failures.
  • Dynamic preview URLs (GitHub Actions, Netlify, WP Engine preview): These are treated as development URLs and are restricted.

Key Facts

RequirementDetailSource
PHP version7.4 minimum; 8.0+ recommendedS1
WordPress version5.8 minimumS1
WP Engine pluginCustom JavaScript plugin required for snippet injectionS1
SeaText accountOne account per primary domain; required before installationS1
Domain restrictionsNo localhost, *.local, or dynamic preview domainsS1
Activation signalVisit site, stay 40+ seconds; site name appears in dashboard within 5–10 minS1
Multi-site supportSeparate account per websiteS1

Limitations and When This Checklist Does Not Apply

  • This checklist covers the standard SeaText JavaScript integration on WP Engine. Enterprise or custom server-side integrations may have additional requirements.
  • If you use a headless WordPress setup (WP Engine as CMS, frontend on Vercel/Netlify), the snippet must be added to the frontend build, not the WP Engine plugin.
  • WP Engine’s Global Edge Security (GES) or advanced WAF rules could theoretically block the SeaText script domain. If the script loads but AI features don’t activate, check WAF logs.
  • SeaText’s AI agents (CRO, translation, bot protection, etc.) are activated separately in the dashboard after the base connection is verified.

Terminology

  • SeaText AI account: Your login that ties a single domain to the platform’s AI agents.
  • JavaScript snippet: The client-side code you paste into the WP Engine Custom JS plugin.
  • Activation handshake: The process where a real visitor session (40+ seconds) signals the SeaText servers that the site is live and linked to your account.
  • WP Engine Custom JS plugin: The WP Engine–provided plugin that safely injects scripts into wp_head or wp_footer across all pages.

FAQ

Can I use one SeaText account for staging and production?

No. Each domain requires its own SeaText account. Staging domains that are dynamic (e.g., pr-42.example.com) are restricted and will not work reliably.

What if my WP Engine plan is on an older PHP version?

Request a PHP upgrade from WP Engine support. PHP 7.4 is the minimum; 8.0+ is recommended for performance and security.

Do I need to deactivate other optimization plugins (Autoptimize, WP Rocket) before installing?

Not required, but clear all caches after pasting the snippet. If the script is minified or deferred incorrectly, the activation handshake may fail. Test with the plugin active first; if the site name doesn’t appear in the SeaText dashboard after 10 minutes, try excluding the SeaText script from minification/deferral.

How long does the activation handshake take?

Stay on a page for at least 40 seconds. The site name should appear in the SeaText dashboard within 5 minutes, up to 10 minutes max. If not, contact support.

Can I install SeaText via a child theme’s functions.php instead of the WP Engine plugin?

WP Engine restricts direct file edits on managed plans. The Custom JS plugin is the supported method. Functions.php edits may be overwritten or blocked.

What happens if I change my primary domain later?

You would need to create a new SeaText account for the new domain and repeat the installation. Accounts are tied to a single primary URL.

Does SeaText work with WP Engine’s headless / Atlas platform?

The JavaScript snippet must be added to the frontend application (Next.js, React, etc.), not the WP Engine backend. The WP Engine Custom JS plugin only affects the WordPress-rendered frontend.

Further reading and comparison sources

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

How SeaText can help

SeaText provides 20+ autonomous AI agents that optimize conversions, translate content into 125 languages, recover ad spend from bot traffic, and personalize pages for each visitor source. The WP Engine integration path is straightforward: install the WP Engine Custom JS plugin, paste your account’s snippet, and verify the connection in the SeaText dashboard. Once connected, you can activate agents for CRO testing, Google Ads landing page matching, bot refund evidence, multilingual translation, and ChatGPT brand visibility — all from one dashboard.

Limitations to know: each domain needs its own SeaText account; development and dynamic preview URLs are not supported; and the initial activation requires a real visitor session of 40+ seconds. If your site is behind a password or maintenance mode, disable it during the verification window.