See how this page can help with your next step.
See how this page can help with your next step.
Leave the activation page? Go back and start the activation step again. The Seatext process does not guarantee that your progress is saved if you leave before the 40-second wait is finished. Your website may not link to your account, and the activation may stay incomplete.
Here is the short recovery path: return to the Seatext page where you added the code, confirm the JavaScript is still installed, visit or refresh your website several times, stay on the page for at least 40 seconds, then wait for your website name to appear next to the SEATEXT logo.
After an accidental exit, the most common symptom is silence. The Seatext dashboard does not show your website name at the top. You may not see an error message, because the activation simply did not finish.
If any of these symptoms appear, do not panic. The fix is usually a short retry, not a full reinstall.
Example: You copied the code, opened your site, got pulled into a meeting, and closed the tab after about 20 seconds. When you return, the dashboard still shows no website name. In that case, refresh your site, stay for 40 seconds, and wait up to five minutes before checking again.
To avoid leaving by accident, do the activation when you can give the browser your full attention for a few minutes. Close extra tabs if that helps, and keep the activation tab in front.
The 40-second stay is not filler. It is the step that activates the AI and links it to your account. Seatext’s integration guide says to visit or refresh your website several times and stay on the page for at least 40 seconds to trigger the link.
That wait gives the page time to load and lets Seatext match the site to your account. Each Seatext account is linked to one primary URL, so the page visit is how Seatext knows which website belongs to which account.
The installation process is secure, and the AI stays inactive until this activation step is complete.
Before you repeat the whole install, check in this order:
Use this order instead of guessing. It is faster to verify the simple causes first.
You do not need to redo activation if your website name already appears next to the SEATEXT logo at the top of the page. That is the confirmation that your website is connected. If you left the page after the 40-second stay and later saw that name, the activation is complete.
You also do not need to keep refreshing all day. The guide says to wait at least five minutes, not to refresh repeatedly during that wait. If the name does not appear after 10 minutes, contact support instead of restarting again and again.
| Fact | Detail |
|---|---|
| Activation stay | Visit or refresh your website several times and stay on the page for at least 40 seconds. |
| Confirmation signal | Your website name appears next to the SEATEXT logo at the top of the Seatext page. |
| Wait time | Wait at least five minutes before expecting the name to appear. |
| Support threshold | Contact support if the website name does not appear after 10 minutes. |
| One account per site | Each Seatext account is linked to a single primary URL. |
| Multiple websites | Use a separate account for each website or domain. |
| Development URLs | Localhost is restricted; dynamic development domains may not work. Use a valid, real domain. |
| WPEngine | Install the WP Engine plugin to add the custom JavaScript across all pages. |
This advice applies to SEATEXT AI activation, not to operating system activation locks, SIM activations, or expired account links. Other vendors have different recovery steps.
Within Seatext, the main exceptions are:
Probably, at least for the activation step. Seatext needs the page visit and the 40-second stay to activate the AI. The good news is that a retry takes only a short active moment, plus the wait for the confirmation.
Your website name must appear next to the SEATEXT logo at the top of the Seatext page. Wait at least five minutes before you expect it.
Play it safe and keep the activation tab active and visible. The instruction says to stay on the page, and there is no official promise that background tab time counts.
After 10 minutes, contact Seatext support. The guide says this could indicate an issue during installation on your platform.
No. Each SEATEXT AI account is linked to a single primary URL. Create a separate account for each domain.
Development URLs such as localhost are restricted for security reasons. Use a valid, real domain instead.
No. This article covers SEATEXT AI. For Apple Activation Lock, SIM activations, or other account activation links, follow that product’s own support guidance.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
Before you troubleshoot further, run through these four checks in order. They resolve the majority of installation errors.
localhost or dynamic preview domains. Use a real, published domain. If you are testing on a staging site, create a separate SeaText account for that domain. Dynamic development domains may not function properly because SeaText cannot reliably associate traffic with your account.If all four checks pass and you still see an error, move on to the next section.
Errors rarely show a single clear message. Instead you’ll see one of these patterns:
Understanding these symptoms helps you narrow down the root cause quickly.
This sequence is the official installation path. Skipping any step can cause a false negative.
SeaText must load in the Header because it needs to initialize before your page content renders. The script sets up a global variable and starts monitoring visitor behavior. If it loads in the Footer, it may run after the page has already loaded, missing key events. Squarespace’s Code Injection panel has three fields: Header, Footer, and Page Header. The Header field injects code into the <head> of every page. The Footer field injects code just before the closing </body> tag. The Page Header field is for individual pages only. For SeaText, you must use the global Header field.
If you accidentally paste the script into the Footer, you may see partial functionality or no connection at all. Move it to the Header field and save again.
Code injection is a plan-gated feature. Personal plans and free trials silently ignore anything placed in Code Injection fields. If you’re on a Personal plan, you must upgrade to Business or higher before SeaText can load. There is no workaround — the platform simply strips the script on restricted plans.
To check your plan, go to your Squarespace dashboard and look at the plan name under Billing. If you are on a trial, you are on the Personal tier. You can upgrade to Business or Commerce to enable code injection. Enterprise plans also support it. If you are unsure, contact Squarespace support to confirm your plan’s features.
Even if you see the Code Injection panel, it does not mean your plan supports it. The panel is visible on all plans, but the code is ignored on Personal and trial plans. This is a common source of confusion.
SeaText ties each account to a single primary URL. If you manage a staging domain and a production domain, create two separate SeaText accounts. Using one account for both will cause the second domain to never register. Also, dynamic development URLs (e.g., *.squarespace.com preview links) are unreliable; always test on the final custom domain.
Development URLs such as localhost are restricted for security reasons. SeaText cannot associate traffic from those addresses with your account. If you are developing locally, use a real domain or a staging subdomain that is publicly accessible.
If you need to use SeaText on multiple websites, create one account for each website. Do not try to share a single account across different domains. This will break tracking and prevent the connection from appearing.
After the script is live, the 40-second visit and five-minute wait are mandatory. SeaText uses that window to fingerprint the domain and bind it to your account. If the site name still hasn’t appeared after 10 minutes, something blocked the handshake — usually a content security policy, an ad blocker on your test browser, or a caching layer serving an old page version. Clear caches, disable blockers, and try again from an incognito window.
To verify the script is loading, open your browser’s developer tools (F12) and go to the Console tab. Look for any errors related to seatext.com or SEATEXTCODEINTEGRATION. If you see a CSP violation, you may need to adjust your security headers. If you see a 404 for the script URL, the script was not injected correctly.
You can also check the Network tab to see if a request to seatext.com is made when the page loads. If no request appears, the script is not running.
Open a support ticket if:
seatext.com).When contacting support, include your domain name, your Squarespace plan, the exact error message from the console, and a screenshot of your Code Injection panel. This helps support diagnose the issue faster.
| Item | Detail |
|---|---|
| Injection location | Settings → Developer Tools → Code Injection → Header |
| Required Squarespace plan | Business, Commerce, or Enterprise (Personal and trials block code injection) |
| Domain rule | One SeaText account per primary domain; localhost and dynamic preview URLs are rejected |
| Activation trigger | Visit live site, stay 40+ seconds; connection appears in dashboard within 5 minutes |
| Support escalation | Contact SeaText support if no connection after 10 minutes on a valid plan and domain |
This guide covers only the SeaText-side installation path. Squarespace occasionally changes the Code Injection UI or adds new plan restrictions without notice. If the Developer Tools section is missing entirely, check Squarespace’s own help center for plan-specific feature lists. SeaText cannot override platform-level blocks.
Also, SeaText requires a real, publicly accessible domain. If your site is behind a firewall or a private network, the handshake may fail. Similarly, if you use a CDN that caches pages aggressively, the script may not load on the first visit. Clear the cache and try again.
Finally, the 40-second visit is a minimum. If you leave the page earlier, the handshake may not complete. Make sure you stay on the page for the full duration.
You’re likely on a Personal or trial plan. Those plans strip custom code on save. Upgrade to Business or higher.
No. Trial sites run on the Personal plan tier and block code injection. Use a paid Business+ plan or a live domain.
Yes. SeaText must load in the Header to initialize before page content renders. Move it to the Header field and republish.
Clear browser cache, disable ad blockers, and revisit the live URL in incognito mode for 40+ seconds. If it still doesn’t connect after 10 minutes, contact SeaText support with the exact domain.
Yes, as long as they resolve to the same primary domain you registered. But separate subdomains (e.g., shop.example.com and blog.example.com) each need their own account.
Password-protected pages still load the Header script, so SeaText will initialize. However, search engines and ad platforms can’t crawl protected pages, limiting SEO and ad agents.
Template changes don’t affect Code Injection settings. The script stays in place. Just verify it’s still in the Header field after the switch.
Check your plan under Billing in the Squarespace dashboard. Personal and trial plans do not support it. Business, Commerce, and Enterprise do. If you are unsure, contact Squarespace support.
A Content Security Policy can block SeaText from loading. You may need to add seatext.com to your allowed domains. If you are using a security plugin, whitelist the script. If you cannot modify the CSP, contact your hosting provider or Squarespace support.
Yes, but you need a separate SeaText account for that subdomain. The subdomain must be publicly accessible, not a localhost or a dynamic preview URL.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
If your SeaText AI plan puts a limit on domains, the fix is straightforward: remove inactive domains to get back under the limit, or upgrade to a plan that covers the domains you actually use. Do not try to make one SeaText account run multiple domains. Each SeaText AI account is linked to a single primary URL, so the real number you need to manage is the number of accounts.
Before you do anything, confirm the limit for your specific plan. SeaText's documentation explains how multiple domains work, but it does not list one universal domain cap. Check your plan details and the pricing page for the exact number.
SeaText AI treats an account and a domain as a pair. The documentation says: "Each SEATEXT AI account is linked to a single primary URL." That design means you cannot point one account at a second website and expect it to track both cleanly.
The same source explains: "If you need to use SEATEXT AI on multiple domains (e.g., a development domain and a production domain), you must create separate accounts for each domain." So a plan that allows a certain number of domains is really allowing a certain number of accounts, each with one primary URL.
The common mistake is trying to "add another domain" inside an existing dashboard. That is not how SeaText works. One website needs one account.
The clearest symptom is a domain that never connects. You install the script, but the site name never appears next to the SEATEXT logo. The account may already be tied to a different primary URL.
Other common signs:
These symptoms can mean a plan problem, a setup problem, or both. Run the diagnosis in this order before you upgrade.
This is the most common cause of "too many domains." You already have SeaText on one site, so you expect the same account to run the second site.
It will not. The documentation says: "To use SEATEXT AI on several websites, create one account for each website." The fix is not a setting change. It is a second account with the SeaText script installed on the second domain.
Development and production are named in the documentation as a reason you need separate accounts. A development domain may be a valid temporary site for testing, but once the test is over, it still counts as a domain slot.
If your plan has a limit, ask yourself: does this domain really need SeaText right now? If not, remove it. That frees a slot without changing your monthly plan.
Example, hypothetical: You run myshop.com and staging.myshop.com. Both are live, but the staging site only exists for internal testing. If your plan covers only one domain, keep the account for myshop.com and remove or close the staging account.
The documentation warns that development URLs such as localhost are restricted for security reasons. It also says dynamic development domains may not function properly because SeaText might not be able to reliably associate traffic with your account.
If you use localhost to test the script, switch to a valid real domain. Otherwise the site will never connect, and you may think the plan is the problem.
| Topic | What SeaText says | What it means for you |
|---|---|---|
| One domain per account | "Each SEATEXT AI account is linked to a single primary URL." | More domains means more accounts. |
| Multiple domains | "You must create separate accounts for each domain." | There is no multi-domain dashboard. |
| Development URLs | "Development URLs, such as localhost, are restricted for security reasons." | Use a real domain for testing. |
| Activation | "Visit or refresh your website several times and stay on your page for at least 40 seconds." | A new domain needs this step or it may not link. |
| Support | "If you do not see it at the top of the page after 10 minutes, please contact our support team immediately." | Do not wait before asking for help. |
Once you know how many domains you actually use, choose between these three paths.
Best when a domain is a staging site, an old project, or a test copy. Removing it costs nothing and gets you back under the limit immediately. Check your account or billing area for the option to delete or close the account, then remove the SeaText script from the site.
Best when every domain is live and important. If removing domains would hurt your business, compare plans on the pricing page and upgrade to a higher domain allowance.
SeaText's documentation does not publish specific plan prices or a universal domain number, so the pricing page is the only reliable place to see what an extra domain costs on your plan.
Sometimes the domain is not the problem; the setup is. For example, a development site may not need real-time AI agents at all. If you only need SeaText on the production site, the "too many domains" problem disappears.
This option is worth checking before you pay for a larger plan.
This order prevents the most expensive mistake: upgrading before you clean up unused domains.
Primary URL is the single web address linked to a SeaText account. You cannot link two primary URLs to one account.
Domain limit is the number of account-and-domain pairs your subscription covers. Your actual number comes from your plan, not from the documentation.
Separate account means a distinct SeaText login used for one domain. It is the only way to run SeaText on several websites.
Keeping these three terms straight avoids most of the confusion behind this question.
No. Each SeaText account is linked to a single primary URL. Create a separate account for the second domain.
No. Development URLs such as localhost are restricted for security reasons. Use a valid, real domain.
Install the script, visit or refresh the site several times, and stay on the page for at least 40 seconds. Wait at least five minutes and look for the website name next to the SEATEXT logo at the top of the page.
Wait up to 10 minutes, then contact SeaText support immediately. The documentation says this could indicate an installation or platform issue.
If your plan counts domains, removing an unused account should reduce how many domains you use. Confirm the exact behavior in your account or on the pricing page.
SeaText's source material does not list a per-domain price. Check the pricing page for the current cost of a plan that covers more domains.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
Audit your copy, identify intent gaps, and use AI to regenerate or adjust copy for each keyword. This is the direct answer to the mismatch problem. Start here, then follow the diagnostic sequence below to fix it systematically.
When your landing page copy doesn't match your keywords, the most visible symptom is a high bounce rate. A visitor clicks your ad because it promises something specific, then lands on a page that talks about something broader or different. They leave within seconds.
This is called Ad Scent Disconnect. The ad smells like what the searcher wanted, but the page doesn't. The visitor feels misled, even if the product is actually a good fit.
If you're seeing this, don't just rewrite the page once. Run a diagnostic sequence to find the root cause, then fix it systematically.
Work through this sequence. Each step rules out a cause or confirms it.
If you find a mismatch at step one, the fix is structural. If the mapping is fine but the copy is off, the fix is editorial.
This is the most common cause. You have a single landing page for a campaign with 50 or 100 keywords. Each keyword represents a different intent, but the page can only say one thing.
For example, "rent house this week" and "studio flat downtown" are different searches. One page can't serve both well. The visitor who searched for a studio flat sees a page about renting houses and leaves.
Sometimes the copy is well-written but it's about your product, not about the searcher's problem. It describes features instead of addressing the specific need behind the keyword.
If someone searches "buy a house near me," they want local options and a clear next step. A page that says "We offer comprehensive real estate services" doesn't answer that.
Even if you create separate pages for each keyword group, you can't predict every variation. Search behavior changes. New keywords emerge. A static page will eventually drift out of sync.
This is where dynamic rewriting helps. Instead of building 100 pages, you let the page adapt to each incoming keyword.
Pull your Google Ads keyword list. Group keywords by intent. For each group, check which landing page they point to.
If one page serves multiple intent groups, you have two options: create separate pages, or make the page adapt dynamically.
The headline is the first thing a visitor reads. It must contain the keyword or a close match. If you have three intent groups, you need three headline variants.
For example, for "apartment for rent" the headline could be "Apartments for Rent Near You." For "studio flat downtown" it could be "Studio Flats in the City Center."
The first paragraph should restate the promise from the ad. Then the proof points should support that specific promise.
If the keyword is "cheap flats to rent," the proof points should mention price, not luxury amenities.
Someone searching "rent apartment quick" wants speed. The CTA should be "Book a Viewing Today." Someone searching "buy a house near me" wants local options. The CTA should be "See Homes in Your Area."
After you make changes, monitor bounce rate and conversion rate. If the mismatch persists, go back to the diagnostic sequence.
Traditional A/B testing can take months on low-traffic pages. If you don't have thousands of visitors, consider AI-driven testing that uses reading telemetry instead of binary conversion tracking.
| Factor | What It Means | Why It Matters |
|---|---|---|
| Ad Scent Disconnect | The ad promises one thing, the page delivers another | Causes most paid clicks to bounce within 3 seconds |
| Keyword Intent | The specific need behind a search query | Different keywords need different copy |
| Dynamic Rewriting | The page changes in real time to match the keyword | Eliminates the need for hundreds of static pages |
| Reading Telemetry | Measures how visitors actually read your page | Finds friction points that binary analytics miss |
This is the most fixable case. Group the keywords into two or three intent clusters. Create a separate page for each cluster, or use dynamic rewriting to adapt the single page.
Creating 100 pages is impractical. Dynamic rewriting is the better solution. The page reads the incoming keyword and rewrites the headline, subhead, and proof points in real time.
This is an editorial fix. Insert the keyword naturally into the headline and first paragraph. Don't stuff it; just make it clear that the page addresses that specific search.
This means the intent is right but the page doesn't deliver. Check the proof points and CTA. Maybe the visitor needs more specific information or a clearer next step.
If your landing page is for a brand campaign, not a keyword campaign, the mismatch is less critical. Brand searchers already know you.
If your product is truly one-size-fits-all, a single page might be fine. But even then, the headline should still match the keyword to avoid confusion.
If you have very low traffic, traditional A/B testing won't work. You need a different approach, like AI reading telemetry or multi-armed bandit optimization.
Most paid clicks bounce because of Ad Scent Disconnect. The ad promises an exact solution to a specific search term, but the landing page is generic. The buyer can't immediately find what they searched for.
You can use a tool that reads the incoming search query and campaign intent parameters on page load, then dynamically rewrites the headline, subhead, and proof points in under 15ms to match the query.
Start with the headline. If the headline contains the exact keyword or a close variant, the visitor will recognize the page as relevant. Then fix the first paragraph and CTA.
No. That's impractical for large campaigns. Instead, group keywords by intent and create a page for each group, or use dynamic rewriting to adapt one page to many keywords.
Standard analytics only show bounces and conversions. AI reading telemetry measures eye-line dwell velocity, friction points, and scroll deceleration to show where visitors lose interest.
Traditional A/B testing requires tens of thousands of visitors. If you have low traffic, use AI-driven testing that analyzes reading behavior and allocates traffic to winning variants automatically.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
If Odoo website data isn't syncing with SeaText, run the checks in this order: confirm the SeaText account is linked to the current site URL, confirm the embed code is in Odoo's Dynamic Content > Embed Code block, and confirm the block isn't hidden by the Hide on Desktop setting. If those all pass, check that your Odoo user can edit website pages and that your network isn't blocking the SeaText script.
Use this guide as a diagnostic path, not a list of isolated fixes. Each step below connects to a documented part of SeaText's Odoo integration.
People describe the problem in different ways:
Those symptoms often come from a setup mismatch, not from corrupted Odoo data. The fastest way to find the cause is to check the setup pieces in order.
Each SeaText account is linked to a single primary URL. This is the most important rule for troubleshooting.
If you have a development domain and a production domain, you need separate accounts for each. Using one account on both is a common mistake. It can make data appear to disappear on one site.
SeaText also restricts development URLs. Localhost is blocked for security. Dynamic development domains may not work because SeaText cannot reliably tie traffic to your account.
Action: log into SeaText, check the primary URL on the account that generated the code, and compare it with the exact URL of your Odoo site, including https and www.
SeaText installs through JavaScript. That JavaScript goes into Odoo's Embed Code module.
The source instructions say to log in to Odoo, access the Website module, navigate to the page, and click Edit. Then scroll through the Blocks panel to the Dynamic Content section. Locate the Embed Code module and drag it into place. In the pop-up window, paste the code snippet provided by SeaText AI, then click Save. If you need to hide the block on desktop, select “Hide on Desktop” in the Visibility section and save again.
This process is secure. The AI remains inert until activated. Installing the code alone does not change your content.
A common mistake is pasting the snippet into a text block or an HTML block. It needs the dedicated Embed Code module. If the script is in the wrong block, the page may still look fine, but SeaText never runs.
Another common mistake is pasting code from the wrong account. Use the snippet that came from the SeaText account whose primary URL matches the site.
After you paste the code, save the page. Then view the page in a private browser window to confirm the SeaText element appears.
SeaText's Odoo instructions mention a Visibility section with a Hide on Desktop option. If that option is checked, the block is hidden on desktop devices. If you can't see the SeaText element, check that setting first.
After you change visibility, click Save again. Then test in a private browser window. Odoo pages can be cached, and a cached page may keep serving the old code. If your site uses a CDN or proxy, flush that cache too.
If the domain, code, and visibility all look right, the blocker may be outside SeaText.
Check whether your Odoo user has permission to edit the Website app. A read-only user can view a page but cannot apply the embed change. Ask an administrator to confirm your role.
Check network-level blockers too. A strict firewall, ad blocker, or content security policy can stop SeaText's script from loading. Test the page on a different network or with browser extensions disabled.
If you use a third-party SeaText Odoo module, confirm it is up to date. The official integration described here uses Odoo's built-in Embed Code block, so a module update is only relevant if you added one.
| Symptom | Likely cause | Next step |
|---|---|---|
| Works in staging, not on live site | One account is linked to one primary URL | Create separate SeaText accounts for staging and production |
| Nothing loads on localhost | Development URLs are restricted | Use a valid, real domain |
| The block never appears | Code is not in the Embed Code module | Drag Embed Code from Dynamic Content and paste the snippet |
| The element is missing on desktop | Hide on Desktop is selected | Uncheck it in Visibility and save |
Each of these mistakes has a simple fix. The diagnostic table above maps symptoms to causes.
SeaText's Odoo integration is a JavaScript embed, not a data pipeline. The installation process is secure, and the AI remains inert until activated. In plain terms, installing the code alone will not change your site content.
This guide covers website data and embed behavior. It does not cover Odoo's internal record sync, such as products or orders moving between Odoo and an external API. That kind of sync has different causes: API credentials, scheduled actions, and server logs. If your error message comes from Odoo's API layer, treat this as a separate issue.
SeaText also warns that dynamic development domains may not function properly. Use a valid, real domain for reliable behavior.
| Fact | Why it matters |
|---|---|
| Each SeaText account is linked to a single primary URL. | You need separate accounts for separate domains. |
| Development URLs such as localhost are restricted for security. | Test on a real domain instead. |
| The embed code belongs in the Dynamic Content section. | Use Odoo's Embed Code module, not a plain text block. |
| Hide on Desktop hides the block on desktop devices. | Check it when the widget does not appear. |
| The AI remains inert until activated. | Installation alone does not change your content. |
Each SeaText account is linked to one primary URL. If both sites share an account, production has no matching account URL. Create separate accounts for each domain.
No. Development URLs such as localhost are restricted for security reasons. Use a valid, real domain for tests.
Check the account domain, confirm the code is in the Embed Code module, uncheck Hide on Desktop if needed, and clear the cache.
The official SeaText integration uses Odoo's built-in Embed Code module. You place SeaText's JavaScript in that module.
Yes. SeaText's instructions say you need a SeaText account before you can install the script.
This article does not cover that. Check Odoo API credentials, scheduled actions, and server logs instead.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
If your site doesn't appear in SEATEXT after installation, the fix usually takes two minutes. Confirm the SEATEXT snippet is in the site-wide header, not the footer. Clear every cache and minification layer. Then visit your site a few times and stay on the page for about 40 seconds. After a few minutes, the site name should show up in your SEATEXT account.
If it still doesn't appear, check that no caching plugin or minification rule is stripping the script. Also confirm you're using a real public domain, not localhost or a temporary development URL. Each SEATEXT account links to a single primary URL, so a staging domain needs its own account.
Almost every case of a missing site comes down to one of these five mistakes.
Work through these in order, and you will usually find the problem in the first two minutes.
Here is a clear sequence to follow. Do every step; skipping one is how people stay stuck.
After a few minutes, your website name should appear in your SEATEXT account. If it doesn't, re-check the header placement and the caching rules.
The snippet is small and inline. That makes it an easy target for aggressive page-speed tools.
Server and CDN caches. If your host or a CDN like Cloudflare serves a cached version of your HTML, the snippet won't be there yet. Purge the cache after every change to the header.
Plugin optimization. WP Rocket, LiteSpeed Cache, Autoptimize, and similar tools can minify or combine scripts. When they do, an inline script can be dropped. Add SEATEXT to the exclusion list for minification and script combination.
Browser cache. An old tab may still hold the previous page without the snippet. Hard-refresh with Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac), or open a private window.
The quickest way to confirm the script is live is View Page Source. Search for "seatext". If it's there, caching is not the problem. If it's missing, one of these layers removed it.
SEATEXT's instructions say the snippet belongs in the header. This isn't a style preference. The script must run before the page finishes loading to connect the visit to your account.
A footer snippet can still run, but it may load after SEATEXT's detection window closes, especially on slow pages or pages with heavy scripts.
Many themes place footer content late in the HTML. If your theme injects scripts in the footer only, the snippet may never execute in time. Move it to the header and test again.
If your CMS doesn't have a simple global header field, use a header-injection plugin. WPCode and Insert Headers and Footers are common options. The goal is the same: place the snippet in the site-wide header so it runs on every page.
SEATEXT ties each account to a single primary URL. That has three practical effects.
One account per site. If you want SEATEXT on a staging domain and a production domain, create a separate account for each. One account can't serve two URLs.
Localhost won't work. Development URLs such as localhost are restricted for security reasons. Use a real domain whenever possible.
Temporary dev URLs fail silently. Dynamic or temporary preview URLs can change per session, so the connection doesn't stick. Avoid them if you can.
Before troubleshooting anything else, make sure you're browsing the exact domain that's registered in your SEATEXT account. A small typo or an extra "www" can point the script at the wrong site.
| Item | Detail |
|---|---|
| Primary URL | Each SEATEXT account links to a single primary URL. |
| Localhost | Restricted for security; use a real public domain. |
| Staging vs production | Create a separate account for each domain. |
| Verification time | Stay on the page about 40 seconds after refresh; check after a few minutes. |
| WordPress plugin | No longer offered; use the JavaScript snippet instead. |
| Cache handling | Clear caches and exclude SEATEXT from minification rules. |
This guide assumes you've correctly placed a snippet that isn't loading. In a few situations, a different problem is at work.
If none of the steps above help and your domain is public and correctly cached, check your platform's SEATEXT installation page again for any recent changes to the snippet format.
Usually a few minutes. After you refresh the site several times and stay on the page for about 40 seconds, check your account again.
No. SEATEXT no longer offers a WordPress plugin. Add the snippet to the site-wide header with your theme's custom code area or a header-injection plugin.
Yes, but create a separate SEATEXT account for the staging domain. Each account is linked to a single primary URL.
That is usually cache. The device with the cached page may not have loaded the snippet. Hard-refresh or clear the browser cache on that device.
Use a dedicated header-injection plugin that inserts code after your theme loads, or check your theme's settings for a custom code area. The snippet needs to be in the site-wide header on every page.
No. Development URLs such as localhost are restricted for security reasons. Use a real domain.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
Follow this order to isolate the problem quickly. Do not skip steps.
https://connect.squareupsandbox.com) and not the production URL. A common mistake is using live credentials in sandbox or vice versa.400 BAD_REQUEST, 401 UNAUTHORIZED, or 404 NOT_FOUND. The error message often tells you exactly what is wrong (e.g., missing required field, invalid card data).200 OK response. Use a tool like webhook.site to inspect incoming payloads during testing.409 CONFLICT error. Generate a unique key for each request.This is the most frequent issue. Developers accidentally use production tokens in sandbox or sandbox tokens in production. Double-check the base URL and token in your configuration file. Square sandbox tokens start with EAAA (sandbox) while production tokens start with EAAA as well but are tied to a live application. The easiest way to confirm is to make a simple ListLocations call and see if it returns test locations.
Square's sandbox only accepts specific test card numbers. Using a random card number will result in a 400 BAD_REQUEST with an error like CARD_TOKEN_ISSUE. Always use the official test card numbers from Square's documentation. For example, 4111 1111 1111 1111 with any future expiry date and any CVV will simulate a successful payment.
Square enforces idempotency for payment and order creation requests. If you send the same request twice with the same idempotency key, Square returns the same response (no duplicate charge). But if you reuse a key for a different request, you get a 409 CONFLICT. Generate a new UUID for each unique request.
If your integration uses webhooks, the endpoint must be publicly accessible during testing. Localhost URLs (e.g., http://localhost:3000/webhook) will not work. Use a tunneling service like ngrok to expose your local server, or deploy to a staging environment. Square will retry failed webhook deliveries up to three times, but you should verify the endpoint responds with 200 OK within a few seconds.
Square applies rate limits to API calls. In sandbox, the limits are lower than production. If you make too many requests in a short period, you will receive a 429 TOO_MANY_REQUESTS error. Implement exponential backoff in your code to handle this gracefully.
| Fact | Detail |
|---|---|
| Sandbox URL | https://connect.squareupsandbox.com |
| Production URL | https://connect.squareup.com |
| Test card numbers | Provided by Square; do not use real cards |
| Idempotency keys | Required for payment and order endpoints |
| Webhook testing | Use ngrok or a public staging URL |
| API Explorer | Available at https://developer.squareup.com/explorer |
| Rate limits | Stricter in sandbox; implement retry logic |
The sandbox environment is not identical to production. Some features are limited or behave differently:
If your integration relies on these features, plan for additional testing in production with a small live transaction (e.g., $1.00) after sandbox validation passes.
Your access token is likely invalid or belongs to a different Square application. Generate a new sandbox token from the Developer Dashboard and update your code.
No. Square's sandbox only accepts specific test card numbers. Using a real card will fail with a card error. Use the test numbers from Square's documentation.
Use a tunneling service like ngrok to expose your local server to the internet. Then set your webhook URL in the Square Developer Dashboard to the ngrok URL. Square will send events to that URL.
You reused an idempotency key for a different request. Generate a new unique key (e.g., a UUID) for each API call that requires idempotency.
Webhooks in sandbox are not guaranteed to be real-time. They may arrive after a delay or not at all. Use the Developer Dashboard to manually trigger webhook events for reliable testing.
Yes, you can test refunds using the sandbox API. Use a test payment ID from a previous sandbox transaction. Refunds will be simulated and no real money moves.
Check that you are using the production access token and base URL. Also verify that your production Square account is active and has the necessary permissions (e.g., payment processing enabled). Test with a small live transaction to isolate the issue.
Understanding when to escalate or change your approach can save hours. Here are common scenarios and how to decide.
This almost always means you used a real card number in sandbox. Switch to a test card from Square's list. If the error persists, check that the card data format matches Square's requirements (e.g., expiry as MM/YY, CVV as 3-4 digits).
First, confirm your endpoint is publicly reachable. Use a tool like ngrok. Then, in the Square Developer Dashboard, go to Webhooks and click "Send test event." If the test fails, your endpoint may have a code error. Check server logs for incoming POST requests.
You may be generating the same key for different requests. Ensure you create a new UUID per request. Some developers accidentally hardcode a static key. Use a library like uuid in Node.js or UUID.randomUUID() in Java.
Sandbox rate limits are lower than production. If you are load testing, add delays between requests. Square recommends at least 1 second between calls. Use exponential backoff: wait 1 second, then 2, then 4, up to a maximum.
Each step in the diagnostic sequence targets a specific failure mode. Skipping steps leads to wasted time. For example, checking credentials first avoids debugging a correct code path with wrong tokens. Inspecting error codes gives you the exact problem, not a guess. Using test cards ensures you are not blocked by real card network rules. Webhook verification prevents silent failures where payments succeed but notifications never arrive. Idempotency keys protect against duplicate charges even in testing. The API Explorer confirms your payload structure before you write code. Together, these steps reduce debugging time from hours to minutes.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
After pasting the SeaText JavaScript snippet into your site, the system needs to verify the connection. Do the following in order:
The website name next to the SeaText logo is the visual confirmation that your domain is linked to your SeaText account. Until that link exists, none of the AI agents — translation, CRO, Google Ads optimization, bot protection, or personalization — can activate. The name is not decorative; it's the status indicator that the snippet is communicating with SeaText's servers and that your account owns the traffic.
SeaText uses a lightweight JavaScript snippet that loads asynchronously. When a real visitor (or you) loads a page containing the snippet, the script sends a ping to SeaText with the domain and account ID. The dashboard polls for that signal. Once received, it displays the website name. The 40-second dwell requirement filters out bots and pre-rendered crawler hits that don't execute JavaScript fully.
Key points from the official integration guide:
localhost or dynamic preview domains are restricted for security and will not register.Open your live homepage, view page source (Ctrl+U), and search for seatext or the script URL. If it's missing, the snippet wasn't saved in the right template or was stripped by a minifier.
Open browser DevTools → Console. Look for errors like "Refused to load script" or "Content Security Policy violation." If present, add SeaText's script domain to your CSP script-src directive.
SeaText only registers the exact primary URL linked to the account. Subdomains, staging environments, or www vs. non-www mismatches can prevent registration. Ensure the account's primary URL matches the live domain exactly.
If you use a caching plugin (WP Rocket, Varnish, Cloudflare, Magento cache), purge it after pasting the snippet. Then test in an incognito window.
Preview modes in CMS editors often strip scripts or run in sandboxed iframes. Visit the actual public URL.
Dashboard propagation can take up to 10 minutes. Refreshing the SeaText dashboard during this window is fine, but don't assume failure before the window closes.
The integration guide instructs placing the snippet in Content → Design → Configuration → [Store View] → Edit → HTML Head → Scripts and Style Sheets. Common mistakes:
bin/magento cache:flush) after saving.magento.local which SeaText rejects.Snippets added via theme header.php can be lost on theme updates. Use a plugin like "Header Footer Code Manager" or the SeaText WordPress plugin if available. Clear all caching layers (plugin, server, CDN).
Paste the snippet in Online Store → Themes → Edit Code → theme.liquid inside the <head> tag. Shopify's cache invalidates quickly, but theme edits may take a minute to propagate.
Ensure the snippet renders in the initial HTML response, not injected via client-side routing after mount. SeaText's ping fires on page load; if the script loads after hydration, the first visit may not register.
Contact SeaText support if:
Support can check server-side logs for pings from your domain and identify whether the script is reaching SeaText. They can also confirm the account-to-domain mapping.
| Fact | Detail |
|---|---|
| Activation trigger | Real visit ≥ 40 seconds on live domain with snippet present |
| Dashboard update window | 5–10 minutes after first qualified visit |
| Account-to-domain rule | One primary URL per SeaText account; multiple domains = multiple accounts |
| Restricted domains | localhost, dynamic preview URLs, staging subdomains not allowed |
| Script behavior | Inert until first qualified visit; then links domain to account |
| Escalation threshold | Contact support if name missing after 10 minutes |
No. Each account is locked to one primary URL. Create a separate account for each domain, including staging if you need to test there.
No. Your own visit works. The requirement is dwell time and JavaScript execution, not uniqueness.
SeaText recommends the <head> for earliest load. Footer placement may still work but delays the ping. Move it to the head if the name doesn't appear.
They can delay or defer execution. Exclude the SeaText script from Rocket Loader via data-cfasync="false" or a Cloudflare Page Rule.
Log into SeaText, go to the main dashboard. The website name shown next to the logo is the registered primary URL. If it's wrong, contact support to update it.
Yes, but GTM loads asynchronously and may add latency. For fastest registration, place the snippet directly in the page <head>.
Once the website name shows next to the SeaText logo, proceed to the Main AI Hub in your dashboard. Activate the agents you need — Translation, CRO Optimizer, Google Ads Landing Page Agent, Bot Protection, or others. Each agent has a configuration panel where you set scope (which pages), parameters, and approval workflows. Start with a small set of pages or keywords, monitor the variant performance reports, then scale.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
SeaText does not use a server-to-server API with Odoo. Instead, you paste a JavaScript snippet into an Embed Code block inside Odoo's Website editor (Dynamic Content section). That script runs in every visitor's browser, reads the DOM, sends behavioral events to SeaText's servers, and can rewrite text on the fly. Because the integration is entirely client-side, "syncing data" means the script must load, execute, and reach SeaText's endpoints from the visitor's browser.
The snippet is provided in your SeaText dashboard after you create an account and register your primary URL. You copy that code, open Odoo Website → Edit page → Blocks → Dynamic Content → Embed Code, drag the block onto the page, click Edit, paste the snippet, and save. Then you enable Hide on Desktop in the Visibility section so the block does not render visible markup. The AI remains inert until you activate it in the SeaText dashboard.
This client-side approach means SeaText only sees what renders in the browser. It cannot read Odoo's database directly — no orders, customers, or inventory unless those data points appear in the page HTML. All telemetry flows from the browser to SeaText's collector endpoint. If anything blocks that flow, the dashboard stays empty.
https:// and subdomain). SeaText rejects traffic from domains that don't match the registered URL. Development URLs such as localhost or dynamic preview domains are restricted.script-src to SeaText's domain, ad-blockers stripping the script, or JavaScript errors in other Odoo modules that halt execution.seatext or the collector endpoint. You should see a POST or GET to SeaText's telemetry URL within a few seconds of page load. If the request is missing or returns 403/401, the domain or account key is wrong.| Item | Details |
|---|---|
| Integration method | JavaScript snippet in Odoo Website > Embed Code block |
| Placement location | Dynamic Content section of the Blocks panel |
| Required visibility setting | Hide on Desktop enabled |
| Domain policy | One SeaText account per primary URL; localhost and dynamic dev domains blocked |
| Multi-domain usage | Separate SeaText account required for each domain |
| Activation state | AI remains inert until activated in SeaText dashboard |
These facts come directly from the SeaText Odoo integration guide. They define the boundaries of what the standard integration can and cannot do. Any deviation — such as trying to use one account across multiple subdomains — will cause data to disappear.
You registered example.com but the live Odoo site serves from www.example.com or a subdomain like shop.example.com. SeaText treats these as different origins. Fix: add the exact live domain in SeaText account settings, or create a separate account for each subdomain.
Odoo or your hosting provider may send a CSP header that only allows scripts from 'self'. The SeaText snippet loads from SeaText's CDN, so the request is blocked. Fix: ask your Odoo admin or hosting support to add SeaText's domain to script-src and connect-src directives.
Extensions like uBlock Origin, Privacy Badger, or Brave Shields often block third-party analytics scripts. Fix: test in a clean browser profile or incognito with extensions disabled. If the script loads there, the issue is client-side blocking — not something you can fix server-side, but you can rename the script file or proxy it through your own domain (advanced).
If you added the Embed Code block only to the homepage, SeaText will only see traffic that lands there. Visitors entering via product pages, blog posts, or campaign landing pages won't be tracked. Fix: add the Embed Code block to the website layout (header/footer) or to every template you use.
Odoo's website cache may serve a cached HTML version without the Embed Code block. Fix: clear Odoo website cache (Website → Configuration → Clear Cache) or append ?debug=assets to the URL to bypass cache while testing.
SeaText enforces one primary URL per account. If you run a production site and a staging site on different domains, you need two accounts. Using the production snippet on staging will send traffic from an unregistered domain, which SeaText discards.
localhost, 127.0.0.1, and dynamic preview URLs (e.g., *.odoo.com staging) are explicitly blocked for security.If the five-step diagnostic passes but data still doesn't appear, investigate these deeper issues.
SeaText updates the snippet when new agents are released. Log into SeaText, go to the integration page, and copy the snippet again. Compare it character-for-character with what's in your Odoo Embed Code block. An outdated snippet may lack endpoints for newer agents.
In the Network tab, click the telemetry request and examine the response. A 200 OK with an empty body is normal. A 403 means the domain key is invalid. A 429 means rate limiting — rare but possible on high-traffic pages. A 5xx error indicates a SeaText server issue; check their status page.
When you are logged into Odoo and editing pages, the website may serve a preview version that strips third-party scripts. Test in a fully public incognito window, not the editor preview.
Odoo loads many JS modules. An error in an unrelated module (e.g., a chat widget or payment gateway) can halt the entire JS execution stack, preventing the SeaText snippet from running. The Console tab will show the first error that stops execution.
Create a blank Odoo page with only the Embed Code block. If data appears there but not on your real pages, something in your theme or other blocks interferes. Disable custom themes or third-party modules one by one to isolate the conflict.
The standard SeaText–Odoo integration is client-side only. Consider a custom server-to-server integration if:
A server-side integration uses Odoo's external API (XML-RPC or JSON-RPC) to push events to SeaText's server endpoints. This requires development effort: you must authenticate an API user in Odoo, write a controller or scheduled action to fetch events, and POST them to SeaText's ingestion API. SeaText's documentation does not cover this path; you would need to coordinate with SeaText support for endpoint details and authentication.
For most marketing teams, the client-side snippet is sufficient. It captures page views, clicks, scroll depth, form submissions, and enables real-time text rewriting. The trade-off is visibility limited to the browser. Choose server-side only when you have a specific backend-data requirement that the snippet cannot meet.
The team added the snippet to the homepage only. Campaign traffic lands on a dedicated landing page template without the Embed Code block. Fix: add the block to the landing page template or to the global header/footer layout.
The staging domain (e.g., staging.example.com) was registered in SeaText, but production (www.example.com) was not. The snippet is identical on both. Fix: register the production domain in a new SeaText account and install its unique snippet.
Cloudflare Rocket Loader defers the SeaText script, causing it to load after the page's interactive phase. Some visitors navigate away before the script fires. Fix: disable Rocket Loader for the SeaText script URL via a Cloudflare Page Rule.
The site uses an AJAX contact form. The SeaText snippet listens for standard submit events but the form uses fetch(). Fix: add a custom event listener in the snippet (advanced) or ensure the form falls back to a standard submit.
*.odoo.com) used for staging; blocked by SeaText for security.The activation flag only means the account is provisioned. Zero visitors means the script isn't firing or the domain filter discards the traffic. Run the diagnostic sequence above.
No. Each distinct domain or subdomain requires its own SeaText account. Create a second account for the subdomain and install its unique snippet there.
No. The JavaScript integration only captures front-end behavior (page views, clicks, scroll depth, form submits). Back-end data like orders stays in Odoo unless you build a custom server-to-server integration using Odoo's external API.
Yes. Cloudflare's Rocket Loader, Mirage, or aggressive caching can defer or rewrite the SeaText script. Disable Rocket Loader for your domain, or add a Page Rule to bypass performance features for the SeaText script URL.
Log into SeaText, go to the integration page, and copy the snippet again. Compare it character-for-character with what's in your Odoo Embed Code block. SeaText updates the snippet when new agents are released.
The browser-side script loses context on cross-domain redirects. You would need to pass a SeaText visitor ID through the redirect chain and fire a server-side event from Odoo's payment confirmation controller — a custom development outside the standard snippet.
SeaText does not provide an official Odoo module. The supported method is the Embed Code block. Community modules may exist but are not maintained by SeaText.
An extension (ad-blocker, privacy tool) is blocking the script. Disable extensions one by one to identify the culprit.
If you've confirmed the domain matches, the script loads without console errors, network requests return 200, and you still see no data after 30 minutes of live traffic, open a support ticket from the SeaText dashboard. Include your account ID, the exact Odoo URL, and a HAR file of the page load.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
If Seatext activation fails on Tilda, first verify you pasted the JavaScript snippet into the correct Tilda HEAD field or T123 block. Then save and publish the site. Visit the live URL for at least 40 seconds. Wait five minutes. If the site name still does not appear next to the Seatext logo, contact Seatext support with error logs, the Tilda site URL, and a screenshot of the code placement.
Activation usually stalls for one of three reasons: the script never loads, the script loads but cannot phone home, or the account-to-domain link never registers. Tilda sites serve pages through a CDN, so a typo in the HEAD field, a missing publish step, or a development domain like localhost will all look like a successful install while the agent stays inert.
If you only need the script on a single page, use the block method instead: add block T123 (under Other), open Content, paste the snippet into the HTML editor, save, and publish that page.
| Symptom | Likely Cause | Quick Test |
|---|---|---|
| No script tag in page source | Snippet not pasted, wrong field, or not published | View page source on live URL; search for seatext |
| Script tag present but console shows 403/401 | Domain mismatch or development URL blocked | Check browser dev tools → Network → seatext request |
| Script loads, no errors, but dashboard never shows site name | Visit duration too short or cookie blocked | Stay 40+ seconds, allow third-party cookies, retry |
| Dashboard shows site name but agents stay "Inactive" | Agent not toggled on in dashboard | Open Seatext dashboard → Agents → enable desired agents |
Tilda has two HEAD fields: one for the whole site (Site Settings) and one per page (Page Settings → Additional). Pasting into the per-page field while expecting site-wide activation is a common mistake. Fix: use the site-wide field unless you deliberately want single-page activation.
Seatext restricts localhost, 127.0.0.1, and dynamic preview domains for security. Each Seatext account binds to one primary URL. Fix: use a real domain (e.g., staging.yourdomain.com) and create a separate Seatext account for each domain.
Tilda saves changes in the editor but does not push them to the CDN until you click Publish. Fix: publish after every code change.
The activation handshake requires a real browser session of at least 40 seconds. Automated crawlers or quick preview clicks do not count. Fix: open the live site in a normal browser tab, scroll, wait, refresh.
Ad blockers, privacy tools, or corporate proxies can strip the Seatext beacon. Fix: test in an incognito window with extensions disabled.
| Item | Detail | Source |
|---|---|---|
| Installation method | Paste JS snippet into Site Settings → HEAD field or page-level T123 block | S1 |
| Account requirement | One Seatext account per primary domain | S1 |
| Development domains | Localhost and dynamic dev URLs restricted | S1 |
| Activation trigger | Visit live page ≥ 40 seconds, then wait 5 minutes | S1 |
| Success indicator | Site name appears next to Seatext logo in dashboard | S1 |
| Multi-site usage | Separate account required for each website | S1 |
<head> section of an HTML document where metadata and external scripts are declared.An agency builds client-staging.agency.com on Tilda, pastes the snippet into the site-wide HEAD field, publishes, but the dashboard stays blank. They used the production Seatext account tied to client.com. Fix: create a new Seatext account for the staging domain, copy that account's snippet, republish, and wait.
A founder edits in Tilda's preview iframe, sees the script in the preview source, assumes it works, but the live site never activates. Preview iframes use a temporary Tilda subdomain that Seatext rejects. Fix: publish to the real custom domain, visit that URL, wait 40 seconds.
Internal QA team loads the live site from the office network; the script tag is present in dev tools but the Network tab shows the Seatext request blocked by policy. Fix: test from a personal mobile hotspot or ask IT to allowlist *.seatext.com.
Complete the 40-second visit, wait five full minutes, then check the dashboard. If the site name is still absent, gather logs and contact support.
Open browser dev tools → Console and Network tabs. Filter for seatext. Screenshot any red errors, copy the request/response headers for the Seatext beacon, and note the exact Tilda URL you tested.
No. Each primary URL requires its own Seatext account. Create a second account for the second domain.
Yes. "Publish all pages" pushes every page to the CDN. If you only edited the site-wide HEAD field, either button works. If you used a page-level T123 block, publish that specific page.
Activation and agent enablement are separate. After the site name appears, go to the Seatext dashboard → Agents and toggle on the agents you need (e.g., Conversion Agent, Translation Agent).
The script will load, but the activation handshake requires a public, crawlable URL. Password protection or IP allowlists will prevent the backend from verifying the domain. Use a public staging subdomain instead.
Not recommended. The snippet contains a unique account token and must execute as-is. Minification can break the token or load order. Paste the raw snippet directly into the HEAD field.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
If SeaText AI doesn't appear after installation, first verify the code was added correctly. Then wait 5-10 minutes. Refresh your site and stay on a page for 40 seconds to link it to your account. If your website name still doesn't show next to the SEATEXT logo in your account dashboard, contact support immediately. This guide explains every step in detail.
SeaText AI depends on correct code placement and activation steps. The most common reason is that the JavaScript snippet was pasted in the wrong place. It must go in the header section of your website HTML. Many users mistakenly put it in the footer. That breaks the activation.
Another culprit is caching. Your website may be serving a cached version of the page. This hides the new script. Caching can happen at several levels: browser cache, server cache, CDN cache, or a caching plugin. Any of these can delay the script from loading.
Time also matters. Even with perfect installation, the AI needs a few minutes to detect your site. The official instructions say to wait at least five minutes. After ten minutes, if the website name hasn't appeared, it signals a deeper issue.
Development URLs like localhost are restricted. They are not publicly accessible, so the AI cannot verify the installation. Use a live, public domain. Dynamic development domains that change often may also fail because the AI cannot reliably associate traffic with your account.
Theme and plugin conflicts can interfere too. Some security plugins block external scripts. Some themes load scripts incompatibly. These conflicts can prevent SeaText from running.
Start by checking your website's HTML. Open your site in a browser. Right-click and select "View Page Source." Press Ctrl+F and search for "seatext" or the script's identifier. If you don't find it, the code wasn't added correctly.
Use browser developer tools for a deeper check. Press F12 to open the tools. Go to the "Console" tab. Look for any JavaScript errors. A red error about SeaText indicates a problem. Then go to the "Network" tab. Refresh the page. Look for requests to seatext.com or related domains. If none appear, the script isn't being loaded.
In WordPress, you can also verify through the plugin. Go to Settings > Insert Headers and Footers. Confirm the code is in the "Scripts In Header" text area. Click Save and then revisit your site.
On other platforms, use their built-in code editors. For example, Shopify's theme editor, Wix's Custom Code, or Webflow's Project Settings. Ensure the code is present and saved.
SeaText supports a wide range of platforms. The core requirement is the same: place the JavaScript in the header. But each platform has its own method.
Use the "Insert Headers and Footers" plugin. Go to Plugins > Add New, search for that name, install and activate it. Then go to Settings > Insert Headers and Footers. Paste the SeaText code into the "Scripts In Header" section. Save. That's it. Wait for detection.
In Shopify, go to Online Store > Themes. Click the three dots next to your theme and select "Edit Code." Find theme.liquid. Paste the script just before the closing </head> tag. Save your changes. Then refresh your storefront and stay for 40 seconds.
In Wix, go to Settings > Custom Code. Click "Add Custom Code." Paste the script. Choose to load it on all pages. Set the placement to "Head." Click Apply and then publish your site. Refresh and stay.
In Webflow, open your project's Settings. Go to the "Custom Code" tab. In the "Head Code" section, paste the script. Save changes. Then publish the site. Refresh and stay.
SeaText also supports Tilda, WooCommerce, Magento, Odoo, Squarespace, GoDaddy, HubSpot, BigCommerce, Weebly, Elementor, Carrd, Square, Thinkific, and WP Engine. Most have a custom code area in their settings or theme editor. Look for a "Custom Code" or "Header Scripts" option. For general/custom websites, add the script directly to the <head> section of your HTML source.
These mistakes are frequent and easy to fix.
Using a staging site: SeaText only works on live domains. If you install it on a staging URL, the AI cannot connect. Use your production domain.
Multiple instances of the script: Adding the code twice causes conflicts. Search your theme and plugins. Ensure only one copy exists.
Forgetting to save changes: It sounds obvious, but many paste the code and leave without saving. Always click Save or Publish.
Using an outdated snippet: Copy the latest code from your SeaText account. Old snippets may contain errors or be blocked.
Cache issues: Caching plugins like W3 Total Cache or WP Rocket can serve old HTML. Clear all caches after installation.
Dynamic development domains: URLs that change frequently, like some staging services, may not register. Use a stable URL.
Incorrect placement in page builders: Some page builders have their own header options. If you use Elementor or similar, ensure the script goes via the theme's header or a dedicated code plugin.
The activation step is critical. You must visit your website and stay for 40 seconds. This allows the script to run and establish a session with your account. During that time, the AI loads its base configuration and confirms the site is live.
Why 40 seconds? It's enough time for the JavaScript to execute completely. It also prevents accidental activation from brief visits. Once activated, the AI becomes active and starts monitoring visitor behavior.
To confirm activation, check your SeaText account. The website name should appear next to the logo. This indicates the connection is successful. If it doesn't appear, revisit the activation steps and ensure you stayed long enough.
Once the AI is active, it begins its work. It reads each visitor's intent based on keywords, campaign, and source. Then it rewrites headlines, offers, product blocks, and CTAs to match that intent. This can improve conversion rates significantly.
The AI also detects bot clicks. It documents suspicious sessions and prepares evidence for ad refunds. You can recover up to 20% of wasted Google and Meta ad spend.
If you activate the Translation Agent, it can translate your site into 125 languages. The Visitor Source Agent adapts pages based on traffic source. The CRO Optimizer runs A/B tests and rolls out winning variants automatically.
You control which agents run from your dashboard. Start with one that matches your biggest need. The AI runs continuously, fine-tuning copy without manual effort.
| Fact | Details |
|---|---|
| Installation Time | Under 1 minute with plugins |
| Wait Period | 5-10 minutes for website detection |
| Activation Step | Stay 40 seconds on a page |
| Domain Restrictions | No localhost; use live domain |
| Multiple Domains | Separate account per domain |
| Support | Contact after 10 minutes |
SeaText has limitations. It won't work on development URLs. Dynamic domains may fail. Each account is tied to a single primary URL. For multiple sites, create separate accounts. Also, the AI requires JavaScript to be enabled in visitor browsers. It won't function otherwise.
If it's been over 10 minutes, contact support immediately. There may be an installation error or a platform-specific issue that needs manual intervention.
Yes, as long as the subdomain is a live, public URL. For example, www.example.com or shop.example.com works. The AI needs access to your server.
Clearing cache is safe. It forces your site to load fresh HTML. This might actually help the script appear faster. Just ensure the code is saved in the source first.
Yes. Elementor is supported. However, don't rely on Elementor's own code injection unless it places code in the header. Use a dedicated header plugin or theme customizer for best results.
For security and reliability. The SeaText servers need to verify your site from the outside. Localhost is only visible to your machine, so verification fails.
Wait at least 5 minutes. If after 10 minutes the site name isn't in your account, contact support.
No. Each account is linked to a single primary URL. To use multiple websites, create a separate account for each.
Follow the official instructions for your platform. If you used a general method, ensure the script is in the header. If unsure, use a header plugin or consult support.
No. The AI remains inert until activated. It loads lightweight JavaScript and doesn't slow down your pages. Once active, it optimizes content without adding overhead.
SeaText support is available through your account. Look for the contact form or email link. They respond quickly to installation issues.
JavaScript Code: The snippet provided by SeaText that must be added to your site's header.
Activation: The process of linking the AI to your account by visiting a page and staying for 40 seconds.
Primary URL: The main website address associated with your SeaText account.
Cache: A stored copy of your site's pages. It can delay script loading.
Dynamic domain: A URL that changes frequently, such as some staging URLs.
Page builder: A tool like Elementor or Wix that allows visual site building.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
If SeaText AI doesn't appear after installation, don't worry—this is a common issue that can usually be fixed with a few simple steps. First, make sure you've activated the AI by visiting your website and staying for at least 40 seconds. Then, wait 5-10 minutes for the connection to complete. If the problem persists, reach out to SeaText support right away.
Understanding why this happens can help you resolve it faster. The installation process requires specific actions to link your website to your SeaText account, and missing a step can delay or prevent the AI from appearing. This guide explains the common causes, the exact activation process, and the troubleshooting steps you should follow.
Several factors can prevent SeaText AI from showing up, even if you've installed the code. The most common cause is incomplete activation: the AI needs to detect visitor activity on your site to connect properly. Another reason could be a delay in processing—sometimes, it takes a few minutes for the system to recognize your website.
Other issues include using an invalid domain, like localhost or a development URL, which SeaText restricts for security. Also, if you haven't created a SeaText account or linked it to your website, the AI won't activate. Always ensure you're using a real, public domain for installation. Additionally, the code might be placed in the wrong location, or the page might be cached by your browser, preventing the script from running.
Sometimes, the problem is with the account itself. Each SeaText AI account is linked to a single primary URL. If you have multiple domains or try to use a testing URL, the connection won't establish. Development domains often fail because SeaText AI might be unable to reliably associate traffic with your account. For these scenarios, you need separate accounts for each domain.
SeaText AI installation involves adding a JavaScript code snippet to your website's header or footer. This code is inert until activated, meaning it doesn't affect your site until you take specific steps. For WordPress users, the recommended method is using a plugin like "Insert Headers and Footers" to paste the code easily.
Once the code is in place, activation happens when you visit your website and engage with it—staying on a page for at least 40 seconds signals to SeaText that the site is active. After this, the AI links to your account, and your website name should appear in your SeaText dashboard within minutes.
The activation process is designed to protect your website's integrity. The script remains dormant until the activation visit confirms that the site is live and under your control. This prevents the AI from running on unauthorized or misconfigured sites. It also ensures that traffic analysis is accurate, which is critical for the AI's performance metrics.
Follow these steps to diagnose and fix the issue:
These steps cover the vast majority of cases. The most common mistake is skipping the activation visit or not waiting long enough. Another frequent error is using a development URL, which SeaText blocks for security.
To confirm SeaText AI is working, log in to your SeaText account and look for your website name in the top-left corner of the dashboard. This indicates a successful connection. You can also test by making a small change in your SeaText settings, like activating an AI agent, and seeing if it affects your site.
Another way is to monitor traffic or use browser developer tools to check for SeaText script loading without errors. Open your browser's developer console (F12), go to the Network tab, and reload your site. Look for a request to the SeaText domain. If the script loads and you've followed activation steps, the AI should be active.
You can also verify by checking the page source in your browser to ensure the script tag is present and not removed by caching or minification plugins. If you see the script but the dashboard doesn't show your site, the activation may not have completed.
Contact SeaText support if you've waited over 10 minutes after activation and still don't see your website name. This could signal an installation error, account mismatch, or technical glitch. Provide details like your website URL, account email, and steps you've taken to help them diagnose quickly.
You can reach support through the contact options on the SeaText website. They offer direct assistance to ensure your installation is correct and can guide you through any platform-specific adjustments. Make sure to mention that you've already performed the activation visit and waited the required time, so they can focus on deeper issues.
Support is especially important if you're using a non-standard platform or a custom-built site. SeaText supports WordPress, Shopify, Wix, Webflow, and many others. If your platform isn't listed, the "General / Custom" option might apply, and support can help you manually add the script.
SeaText AI has some limitations to keep in mind. Each account is linked to a single primary URL—you cannot use one account for multiple domains; instead, create separate accounts for each website. Development URLs like localhost are restricted for security reasons, so always use a valid, real domain.
Additionally, the AI requires visitor activity to activate, so if your site has low traffic or you don't visit it after installation, the connection might not establish. These measures ensure the system works reliably and securely across different setups.
Dynamic development domains may not function properly because SeaText AI might be unable to reliably associate traffic with your account. For example, a URL like myapp.herokuapp.com might work, but a localhost or an IP address will not. Always use the exact primary domain that you plan to use in production.
After activating the AI by visiting your website and staying for 40 seconds, it typically takes 5-10 minutes for your website name to appear in your SeaText account. If it doesn't show up after 10 minutes, contact support.
First, ensure you've correctly pasted the JavaScript code into your website's header. Then, activate the AI by visiting your site and waiting on a page for 40 seconds. Confirm your domain is valid and not a development URL, and that you have an active SeaText account. Also check your browser cache.
No, each SeaText AI account is linked to a single primary URL. To use SeaText on multiple websites, you need to create a separate account for each domain.
SeaText restricts development URLs like localhost for security reasons. You must use a live, public domain to install and activate the AI properly.
Contact SeaText support immediately. They can investigate installation issues, account problems, or technical errors that might prevent activation.
SeaText provides support for installation and activation issues as part of their service. Check their pricing page or contact them directly for details on available plans and assistance.
No, because each account is tied to one primary URL. If you need to test on a staging site, create a separate account for that domain. Once you go live, use the production account.
SeaText offers a "General / Custom" option for manually adding the script. If you're unsure, contact support for help specific to your platform.
SeaText AI installation: The process of adding a JavaScript code snippet to your website to enable AI-driven optimizations for conversion, traffic, and more. It requires account creation, code placement, and activation steps.
| Aspect | Detail |
|---|---|
| Installation Method | Use plugins like "Insert Headers and Footers" for WordPress or platform-specific guides for Shopify, Wix, etc. |
| Activation Trigger | Visit your website, stay on a page for at least 40 seconds, and refresh multiple times. |
| Wait Time for Connection | 5-10 minutes after activation for your website name to appear in the SeaText account. |
| Domain Requirement | One account per primary URL; development URLs like localhost are restricted. |
| Support Contact | Reach out if the name doesn't appear after 10 minutes for immediate assistance. |
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
If SeaText AI doesn't connect after installation, don't reinstall yet. Work through the short readiness checklist in this article. First confirm the script is loading, the account matches the domain, and at least one agent is activated. In most cases this fixes the issue without touching the code again.
SeaText installs as a JavaScript snippet. You paste it into your website, usually in Shopify's theme.liquid file. If the snippet never loads, or loads on a domain that isn't linked to your account, SeaText can't connect. Here is what to check, in the order that finds broken connections fastest.
Before changing anything, know what a failed connection looks like. Check these symptoms:
The integration guide says: 'Before you can install the script, you need a SEATEXT AI account.' The script is tied to an account. If you skip this step, there is nothing for the script to connect to. Create the account first, then copy the JavaScript snippet from inside that account.
Each SEATEXT AI account is linked to a single primary URL. If you paste the snippet on a different domain, a subdomain, or a staging environment, SeaText won't know those visits belong to you. For a second website, create a second account.
Development URLs like localhost are restricted for security reasons. Dynamic development domains may also fail because SeaText can't reliably connect traffic to your account. Use a real, valid domain when you test.
In Shopify, open Online Store > Themes > Actions > Edit Code. Go to the Layout folder and open theme.liquid. Paste the snippet where the integration guide shows, then click Save. For product descriptions, the output must be wrapped with the correct tag. If you skip the save button, the code is gone the moment you leave the page.
The guide says the AI 'remains inert until activated.' A loaded script is not the same as an active agent. Go into your SeaText account and check that you've activated at least one agent before you judge the connection.
Run these checks in order. Stop and fix the first problem you find, then move on.
| Symptom | Likely cause | Quick fix |
|---|---|---|
| No SeaText script in page source | Snippet wasn't pasted or saved | Open theme.liquid, paste the snippet, click Save, then reload |
| Data- attribute missing on product page | Product description output isn't wrapped with the tag | Find the product description template and wrap the output, then test |
| Script works on one domain but not another | One account is linked to one primary URL | Create a separate account for the second website |
| Script fails on localhost | Development URLs are restricted | Use a real, valid domain |
| Script loads but SeaText does nothing | Agents haven't been activated | Log in and activate at least one agent |
| Fact from the integration guide | What it means for you |
|---|---|
| Before you can install the script, you need a SEATEXT AI account. | The script requires an account to connect. |
| Each SEATEXT AI account is linked to a single primary URL. | Use one account per domain and make sure the URL matches. |
| Development URLs, such as localhost, are restricted for security reasons. | Don't test on localhost or non-real domains. |
| The installation process is secure, and the AI remains inert until activated. | Installing alone won't change anything; activate an agent. |
| Verify that the data- attribute is present in the HTML source. | This is the standard test for a working tag. |
The integration guide has hard limits you should know before troubleshooting too long:
If you installed SeaText on a custom platform that isn't Shopify, the general connection rules above still apply, but the exact file names will be different. Look for the global template or layout file where your site's head is rendered.
Because each account is linked to a single primary URL. The guide says this directly. If you want SeaText on multiple websites, you need multiple accounts.
No. Development URLs such as localhost are restricted for security reasons. Use a real, valid domain for any test.
Open the page in your browser, view source, and search for 'SEATEXT.' Then go to a product page and verify that the data- attribute is present in the HTML using browser developer tools.
Maybe not. Check that you clicked Save, the snippet is in the correct file, and you've activated an agent. A loaded script is not the same as an active agent.
Go to the SeaText website and contact support. Before messaging, write down what you've checked: the domain, the account, the file, and the page source result. That will speed up the fix.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
If Seatext AI doesn't work on your product pages, the problem is usually in the setup, not the tool. Check three things first: the JavaScript snippet is installed on the exact page template, the product description is wrapped in the required element with a data- attribute, and the account you are logged into is linked to the same primary URL as your product-page domain. Work through those checks, then inspect the live page with your browser's developer tools. If everything passes and you still see no changes, contact Seatext support with your account URL and a screenshot of the HTML.
This article is a diagnostic guide. It moves from symptoms to likely causes to fixes. It also covers the common mistake that makes Seatext AI look broken on product pages even when the rest of the site works.
Before you change any code, answer these questions:
Follow this order. It rules out cheap fixes first.
Shopify has a specific install path. The Seatext integration guide uses these steps:
Saving theme.liquid loads Seatext on your Shopify pages. But product descriptions need one more step. The product description is usually rendered in a file named product.liquid or product-template.liquid. Find the line that outputs the product description and wrap it with the required element that includes the data- attribute Seatext looks for. Save the file, then preview a product page.
To confirm it worked, open the same product page in your browser's developer tools and inspect the HTML source. The product description element should include the data- attribute. If it is missing, the template edit did not save, or you edited the wrong template.
The most common reason Seatext AI doesn't work on product pages is that the page is being viewed on a domain that does not match the Seatext account. Each Seatext account is linked to a single primary URL. When you paste the script on a second domain or on a staging URL, the account may not associate that traffic with your site. The result looks like a product-page bug, but it is an account mismatch.
This mistake happens often in product-page testing because you can have a development copy of your store at a URL like staging.example.com while the live store is at www.example.com. Seatext treats those as different domains. Create a separate account for each domain, and only test on a real domain. Localhost is blocked. Dynamic development domains may also fail because Seatext cannot reliably associate traffic with your account.
Installing the script is not the same as turning on the feature. Seatext says the AI remains inert until activated. After you add the script, go to your Seatext dashboard and activate the agents you want on product pages. If the script is installed but no agent is active, the page will load normally and no copy changes will appear.
On product pages, the relevant agents are usually the ecommerce product copy agent, the translation agent, or the personalization agent. Which agents you need depends on your goal. The key point is that activation is a separate step from installation. Check that step before you dig into template code.
| Symptom | Likely cause | What to do |
|---|---|---|
| Seatext AI works on homepage but not product pages | Product template is missing the required data- attribute wrapper | Edit product.liquid or product-template.liquid and wrap the product description output. |
| Nothing happens on any page | Script not installed, not saved, or no agent activated | Confirm script in theme.liquid, save, then activate an agent. |
| Changes appear on live site but not in preview or staging | Account is linked to a different primary URL | Create a separate Seatext account for the second domain. |
| You see an error or no script in page source | Snippet was not pasted into the correct file | Recheck Layout/theme.liquid and save the file. |
| Product page loads but description never changes | The data- attribute is missing from the description element | Wrap the product description output and verify with developer tools. |
This guide is based on the official Seatext integration instructions, which currently give the most detail for Shopify. If your product pages run on a custom CMS or a different ecommerce platform, the generic script steps still apply: copy the JavaScript snippet from Seatext, paste it into your site's shared layout file, and make sure the product description markup includes the required data- attribute. The exact file names will be different.
This advice will not fix server errors, database issues, checkout failures, or problems caused by another app that rewrites your theme files. If a browser extension blocks third-party scripts, that can also look like a Seatext failure. Test in a normal browser window or an incognito window before assuming the installation is wrong.
| Fact | What it means for product pages |
|---|---|
| Each Seatext account is linked to a single primary URL. | If your product pages use a different domain, create a separate account for that domain. |
| Development URLs such as localhost are restricted. | Test on a real domain, not your local machine. |
| Dynamic development domains may not function properly. | Seatext may not be able to associate traffic with your account on these URLs. |
| On Shopify, the script goes in Layout/theme.liquid. | Without it, Seatext will not load on your theme. |
| Product descriptions need a data- attribute wrapper. | The product template must output that attribute so Seatext can identify the description. |
| Seatext AI remains inert until activated. | Installation alone will not change copy; you must activate an agent. |
Homepage and product pages often use different template files. The script may be in theme.liquid, but the product description still needs the required data- attribute wrapper in product.liquid or product-template.liquid. If it is missing, Seatext does not know which content to optimize.
No. Development URLs such as localhost are restricted for security reasons. Use a real, stable domain for testing.
Yes. Each account is linked to a single primary URL. If you use a development domain and a production domain, create separate accounts for each.
Check that you activated an agent after installation. Seatext AI stays inert until activated. Then verify the product description markup has the data- attribute.
Open the product page in your browser, use developer tools to view the HTML source, and look for the Seatext script. Then find the product description element and confirm it contains the data- attribute.
Send the primary URL of your Seatext account, the exact product-page URL, and a screenshot of the HTML source showing whether the script and data- attribute are present. That lets support compare your account against the page quickly.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
If SeaText AI fails to connect during Shopify setup, first retry the connection, confirm you are in the correct Shopify admin, and verify that the SeaText JavaScript snippet is installed in your active theme. Most connection failures come from a simple domain mismatch, a missing snippet, or an unsaved edit to theme.liquid.
The steps below follow the SeaText Shopify Integration guide. Use them in order, and test only when a step tells you to.
These checks take less than a minute and solve many failed connections.
Follow this order. Do not skip the verification step.
If the data attribute appears, the script is loaded. The remaining issue is likely on the account side, so move to the account checks below.
During Shopify setup, “fails to connect” means SeaText cannot match the script on your site to your SeaText account. The script may be missing, on a different domain, or on a domain SeaText does not accept.
The domain match matters more than the connection button. SeaText ties each account to one primary URL. If the store URL and that primary URL are not identical, the connection cannot stick.
This is also why you should not ignore the failure. A half-completed setup leaves the snippet on the page without an active account match, and later agents will not be able to run. The installation itself is secure, and the AI stays inert until activated, so you can retry without changing your live content.
| Fact | What it means for your connection |
|---|---|
| You need a SEATEXT AI account before installing the script | The snippet cannot connect if no account owns it. |
| Each account is linked to a single primary URL | Your store URL must match that primary URL exactly. |
| Multiple domains need separate accounts | A development domain and a production domain cannot share one account. |
| localhost is restricted | Development URLs will not work for the connection. |
| Copy the JavaScript code from SEATEXT AI | Use the snippet provided in your account, not one from another site or account. |
| Save and then verify the data attribute | An unsaved or misplaced snippet never reaches the live page. |
Use this table as a quick checklist whenever setup fails.
If the snippet is in the right file and the data attribute appears, the problem is usually account-side.
Start a fresh connection only after the account and domain are aligned.
SeaText restricts development URLs such as localhost for security reasons. Use a valid real domain instead.
No. Each account is linked to a single primary URL, and SeaText requires separate accounts for separate websites.
It is the main domain registered to your SeaText account. The storefront URL must match it for the script to connect.
Save the theme file, preview a product page, and inspect the HTML source in your browser’s developer tools. The data- attribute should be present.
Check that you pasted into the active theme’s theme.liquid, not a duplicate theme or the wrong template. Then compare the account primary URL with the store URL. If both are correct, create a separate account if you are using a second domain.
No. The installation process is secure, and the AI remains inert until activated.
The SeaText Shopify Integration page is the reference for this recovery. It shows where the JavaScript code comes from, which theme file to edit, and how to verify the data- attribute. Keep it open while you retry the connection.
Open the Shopify Integration guide and run through the checklist once more.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
If the SeaText AI script will not install on your Shopify store, do not assume the store is broken. Start with the basics: check your internet connection, make sure you are editing Layout/theme.liquid, and confirm your domain is public. Then work through the diagnostic sequence in this guide. Most installation failures come from a wrong file, a missing save, a copied snippet that lost characters, or a hidden caching issue.
This guide explains why a failed install matters, how SeaText installation works, what can block the script, and what to do after a successful install.
SeaText is not a decorative widget. It is an AI layer that changes what visitors see based on their source, search query, and reading behavior. If the script never loads, none of that happens.
Consider a paid Google Ads visitor. With SeaText, your landing page can rewrite its headline, offer, and call to action to match the keyword the visitor typed. Without the installed script, every visitor sees the same generic page. The page does not match the ad promise, so more visitors leave without buying. Your click spend is spent on visitors who never see a relevant message.
The same is true for bot traffic. SeaText detects bots in paid traffic and builds evidence for refund requests with Google and Meta. If the script is not installed, bot clicks are not flagged, and you cannot recover that wasted ad spend. A failure to install means lost conversion lift and lost refund opportunities.
Site performance is also part of the picture. A correctly placed snippet before </head> loads cleanly and stays inert until you activate it. A bad paste, such as code placed inside another script tag or in the middle of the body, can cause rendering delays and make the page feel slow. Fixing the install reduces those risks.
SeaText gives you one JavaScript snippet from your account. That snippet must be pasted into the global theme file because Shopify uses theme.liquid to render every page. When placed before the closing </head> tag, the browser finds the script early. This is important because the script needs to observe page elements before the visitor starts reading.
The snippet itself does not change content. SeaText says the AI remains inert until activated. That means installing the script is not the same as turning on AI agents. After the snippet loads, you still need to log in to your SeaText account and activate the agents you want, such as the Google Ads Agent, Translation Agent, or Bot Protection Agent.
If you also want SeaText to optimize product descriptions, you may need to add a tag inside the product template. The goal is to mark the product description output so SeaText can identify it. After you save the product template, use your browser developer tools to confirm the data- attribute appears in the HTML source.
SeaText links each account to one primary URL. Multiple domains require separate accounts. Development URLs like localhost are restricted for security reasons. A real, publicly reachable domain is required.
Even when the theme file looks correct, outside factors can stop the script from executing. Here are the most common blockers.
A Content Security Policy is a set of browser rules that decide which scripts can run. Some Shopify stores add a CSP through a security app or custom code. If the policy does not allow the domain SeaText loads from, the browser blocks the request. The script tag stays in the HTML, but the script never runs.
If you use a CSP, whitelist the domain SeaText loads from. Check with SeaText support for the exact domain if you cannot find it in your account.
Shopify uses a content delivery network to serve store pages. After you save a theme change, the new version is compiled and sent to the CDN. In most cases this happens within seconds. However, browser cache, Shopify cache, or a third-party caching app can serve an old version of theme.liquid for a while.
If you inspect the page and do not see the script, first clear your browser cache or open the store in an incognito window. If you use a caching app, purge its cache as well. Then reload the page.
Shopify themes can contain app extensions that inject their own scripts into the head. These extensions are controlled by other apps and may alter the order of scripts. An aggressive extension can remove or override code that was pasted manually.
If your theme uses many app blocks, disable non-essential apps temporarily. This helps you see whether another app is interfering. Then re-enable apps one at a time to find the conflict.
JavaScript runs in the order the browser executes it. If SeaText is placed after a slow script, it may execute later than intended. If it is placed in the body, it may miss the early page events it needs. That is why SeaText should sit before </head> in the layout file, not in a page section or after a third-party widget.
Use this sequence when SeaText does not install or does not appear after saving.
Layout/theme.liquid, not a section file or a template file. The wrong file will not apply globally.seatext or look for the data- attribute on product pages.If every step passes and the script still does not run, the problem may be inside the theme itself. Try a different browser, then a different device. If the issue persists, contact SeaText support with a screenshot of your theme file and the browser console errors.
This is the exact repair path. It overlaps with the diagnostic sequence only where an action is required.
theme.liquid.<head> area in theme.liquid and paste the snippet just before </head>.data- attribute. If neither appears, repeat the diagnostic steps.product.liquid or product-template.liquid) and follow SeaText instructions for wrapping the product description. Then save and test again.Do not add the snippet to a section file unless you are sure that section appears on every page. The layout file is the only file that guarantees global coverage.
Successfully saving the script is only the beginning. Follow these checks to make sure SeaText is live and ready.
Visit the homepage, a product page, a collection page, and a blog post. The script should appear on every page if it is in theme.liquid. If it only appears on some pages, the theme may use different layouts for different page types.
Clear the browser cache, purge your Shopify CDN cache, and clear any third-party caching plugin. Then test again in an incognito window. This removes old copies of the page that might hide the new script.
SeaText can optimize product descriptions when the product template contains the correct data- attribute. Open the product template and verify that the description output is wrapped correctly. Save the file, then visit a product page and inspect the HTML source. The data- attribute must be present.
Right-click a product description and select Inspect. Look for an attribute that starts with data- and contains a SeaText identifier. If the attribute is missing, customers still see content, but SeaText cannot reliably know which text to optimize.
Remember, the script stays inert until activated. Log in to your SeaText account and activate the agents you need. Without activation, the script loads but does not rewrite content or protect against bots.
Every Shopify theme has its own theme.liquid. When you switch themes, the new theme does not inherit your old theme code. You must paste the SeaText snippet into the new theme and save it. You also need to re-add any product template tags.
| Fact | Detail |
|---|---|
| Theme file to edit | Layout/theme.liquid |
| Where to paste | Just before the closing </head> tag |
| How to access | Online Store → Themes → Actions → Edit code |
| Save requirement | Click Save after pasting; unsaved changes never reach the live store |
| Domain restriction | Public domain required; localhost and development URLs are blocked |
| Data- attribute role | Marks product descriptions so SeaText can identify content to optimize |
| Activation | Script remains inert until you activate agents in your SeaText account |
| Theme changes | New themes require a fresh paste; old theme code does not carry over |
| Multiple domains | Create a separate SeaText account for each primary URL |
This usually means the product page uses a different layout or template. Check whether the product page uses the same theme file. Open the product template and confirm the SeaText snippet is in the layout, not in a homepage-specific section. Then clear the cache and inspect again.
SeaText requires a real public domain. A password-protected store may block SeaText from reading the page. Use a publicly accessible test page when you verify the install. If you must test on a protected store, check with SeaText support for a workaround.
Open theme.liquid, delete the SeaText JavaScript block, and click Save. If you added a data- attribute to the product template, remove that too. Clear your caches so old versions of the script do not keep running. Deactivating agents inside SeaText also stops the AI from making changes.
That error usually means the SeaText server could not reach your store. The most common causes are a blocked domain, a network issue, or a store that is not publicly accessible. Confirm your domain is live, then retry the installation.
No. Each SeaText account is linked to one primary URL. For a second store, create a separate account. This keeps traffic and settings separated for each domain.
If you still cannot install the script, contact SeaText support. Include the full error message and a screenshot of your theme.liquid so they can identify the exact issue.
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
You see a green “connected” indicator in the SeaText dashboard. But the AI agents do not rewrite copy, translate pages, or block bot traffic. This is a false positive. The dashboard only confirms that the script reached SeaText’s servers. It does not mean the AI is active on your site.
The connection indicator shows your domain name next to the SeaText logo. That means the script loaded successfully. However, the AI agents need to be activated separately. They also need a clean script environment to run. JavaScript errors, an expired API key, or a cached version of the page can block them.
In short, “connected” is not the same as “working”. You need to diagnose why the AI agents are not executing.
Five main reasons cause this false positive connection:
</head> on every page. If you use WP Engine, install the official plugin. The script must be present on all pages, not just the homepage.JavaScript errors. Other plugins or themes can conflict with the SeaText script. Open the browser console (F12) and look for red error messages. They often reveal the exact conflict.Expired or missing API key. The AI needs a valid API key to function. Check the dashboard’s API settings. If the key expired, generate a new one.Cache or CDN serving an old version. If your site uses a caching plugin or a CDN (like Cloudflare), it may deliver a page without the SeaText script. Purge all caches.Activation wait time not met. After installing the script, you must stay on any page for at least 40 seconds. Then wait five minutes for the dashboard to update. Without this, the connection may not fully register.Additionally, SeaText links one account to one primary URL. If you use multiple domains (e.g., a development domain and a production domain), you need separate accounts per domain. Localhost and other development URLs are restricted for security reasons. They will not show as connected.
Step-by-step diagnostic sequenceFollow this order to find the exact cause. Do not skip steps.
Open the SeaText General Integration page. Copy the latest JavaScript code from General Integration.Reinstall the script. Paste it into your site’s global header (before </head>). If you use WP Engine, use the provided plugin. Save and publish.Visit any page on your site. Stay on that page for at least 40 seconds. This activates the AI and links it to your account.Wait five minutes. Refresh the SeaText dashboard. Look for your site name next to the SeaText logo at the top. If it appears, the connection is established.Check the browser console. Open developer tools (F12) and go to the Console tab. Resolve any red error messages. Common errors: “SeaText is not defined”, “API key missing”, or “Failed to load script”.Clear your cache. Clear the browser cache, or use an incognito window. Also purge any CDN or site cache plugin.Verify the API key. Log into the dashboard, go to API settings. Ensure the key is active and not expired. If expired, generate a new key and update the script.Test again. Reload the page. Wait 40 seconds. Check the dashboard for green status on each agent.If the site name still does not appear after 10 minutes, contact support immediately. This indicates a deeper installation issue.
How to fix each common causeScript not loading or placed in the wrong location. Reinstall from the General Integration page. Ensure the script appears before the closing </head> tag. Use the WP Engine plugin if you are on that platform. The script must be on every page, not just the homepage.
JavaScript errors. Open the console and look for errors. Common fix: temporarily disable other plugins or scripts to isolate the conflict. If the error is “SeaText is not defined”, the script did not load. Check your header file for missing code.
Expired or missing API key. In the dashboard, navigate to API settings. Copy the key. Ensure it is included in the script snippet. If you recently changed the key, update the script on your site. The key is essential for AI to function.
Cache or CDN serving an old version. Clear your site’s cache plugin (e.g., WP Rocket, W3 Total Cache). If you use a CDN, purge the CDN cache. Also clear your browser cache or test in incognito mode. This ensures the latest script is served.
Insufficient activation wait time. After installing the script, stay on a page for at least 40 seconds. Then wait five minutes for the dashboard to update. Do not navigate away during those 40 seconds. The AI needs to see a real visitor session to activate.
Multiple domains or development URLs. Each domain needs its own SeaText account. Development URLs like localhost or staging sites are not allowed. Use a real domain for testing. If you need to test on a development domain, contact support for options.
How to verify the AI is truly activeAfter the steps above, you should see real-time changes. For example, headlines may rewrite, translations may appear, or bot traffic alerts may show. The easiest way to verify is to check the agents panel.
Go to the SeaText homepage. Log in and view the agents panel. Each agent you activated should show a green “Active” status. If an agent shows “Inactive” or “Error”, click on it to see details.
You can also test by visiting a page on your site. Look for changes in the page content. For example, if you activated the Translation Agent, the page may appear in a different language. If you activated the CRO Optimizer, headlines may change based on visitor source.
If you still see no changes after 10 minutes, the AI is likely still blocked. Re-run the diagnostic sequence. Pay special attention to the console errors and API key.
Frequently asked questionsWhy does the dashboard say “connected” but nothing changes on my site? The connection indicator only tells you the script reached SeaText’s servers. The AI agents must be activated separately. Also, the script must run without errors. Check the console and agent activation status.How long should I wait after installing the script? Stay on a page for at least 40 seconds. Then wait five minutes for the dashboard to update. If you don’t see the site name after 10 minutes, contact support.Can a CDN prevent the AI from working? Yes. If the CDN caches a page without the new script, the AI cannot run. Purge the CDN cache and also clear your browser cache.Do I need a separate account for each domain? Yes. SeaText AI links one account to one primary URL. Using multiple domains requires separate accounts. Development URLs like localhost are restricted.What if I see JavaScript errors but can’t fix them? Common errors are caused by conflicting plugins. Temporarily disable other plugins one by one to find the conflict. You can also contact SeaText support with the console error logs.If you have completed all steps and the AI still does not work, contact SeaText support. Provide them with the console errors, the exact URL where the script is installed, and a screenshot of the dashboard connection status. Support can check backend logs for further issues.
Further reading and comparison sourcesThese external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
How to Fix SeaText AI Verification Failures on a Specific PageWhy Page-Level Verification Matters: Telemetry and Bot Refund Agents
When the SeaText AI verification handshake fails on a specific page, the immediate consequence is a total loss of telemetry. This is not merely a technical glitch; it has direct financial and operational implications for your marketing stack. Telemetry is the lifeblood of SeaText's autonomous agents, including the Bot Refund Agent. Without a successful verification, the AI cannot capture visitor behavior, making it impossible to perform real-time conversion optimization or bot detection.
The Bot Refund Agent relies on continuous, high-fidelity telemetry to identify invalid clicks. It analyzes forensic signals, such as mouse movement anomalies, rapid click patterns, and VPN signatures. If the verification fails, the agent cannot record this forensic evidence. Consequently, you lose the ability to automatically prepare refund-ready reports for Google and Meta. Given that bot traffic wastes up to 20% of ad budgets, a verification failure on key landing pages directly impacts your bottom line by preventing you from recovering wasted ad spend.
Verify Script Inclusion and Execution
The first step in troubleshooting is ensuring the SeaText JavaScript is actually loading on the problematic page. If you use a WordPress plugin like 'Insert Headers and Footers,' check that the code is active globally. Sometimes, page-specific settings in caching plugins or optimization tools can accidentally exclude certain pages from script execution.
To verify script loading, open your browser's developer tools (F12) and go to the Network tab. Refresh the page and search for 'seatext'. If the script is missing, re-save the code or ensure your header plugin is not failing on that specific URL. Remember that the AI remains inert until someone visits the page and stays active for at least 40 seconds. This dwell time triggers the initial activation handshake and links the session to your account.
Technical Mechanics of CSP Whitelisting (script-src and connect-src)
A Content Security Policy (CSP) is a security layer that helps detect and prevent certain types of attacks, including content injection attacks. If your site has a strict CSP, it may be blocking the SeaText script from executing or from sending data back to the servers. Understanding the technical mechanics of CSP whitelisting is crucial for developers.
The CSP is enforced via HTTP headers and utilizes specific directives. The two most relevant directives for SeaText are script-src and connect-src. The script-src directive controls where JavaScript files can be loaded from. If the SeaText script domain is not whitelisted here, the browser will refuse to download or execute the script. The connect-src directive controls where asynchronous HTTP requests (AJAX or fetch) can go. SeaText relies on this directive to send telemetry data back to its servers. If either directive is misconfigured, the browser console will display a violation error, halting the verification process.
To resolve this, you must update your CSP headers to whitelist the specific SeaText domains. For example, your header should include script-src 'self' https://seatext.com and connect-src 'self' https://seatext.com. If you use a third-party security plugin, navigate to its CSP settings and add these origins to the whitelist. Always test your changes in a staging environment before deploying them live.
Review Experiment Targeting Rules and Dynamic Logic
SeaText allows you to target experiments to specific URLs, paths, or segments. If the verification is failing only on one page, it is possible that a targeting rule is too restrictive or contains a typo that excludes the actual URL structure. This is particularly important for the Google Ads Agent, which dynamically rewrites landing page copy in real-time to match search keywords.
Go to your SeaText dashboard and check your active experiments. Ensure the URL pattern matches the live page exactly. For example, check if a trailing slash or a query parameter is causing the targeting logic to skip the page. The Google Ads Agent relies on precise targeting to deliver a 0ms zero-flicker page rewrite. If the targeting rules are misaligned, the AI cannot apply its dynamic keyword adaptation, severely hurting your Quality Score and ROAS.
Trade-offs: Real-Time AI Adaptation vs. Traditional Static A/B Testing
When troubleshooting verification, it helps to understand the underlying technology's trade-offs. Traditional static A/B testing relies on binary conversion tracking and null-hypothesis significance testing. It requires tens of thousands of visitors to reach 95% statistical confidence. For low-traffic B2B sites or niche ecommerce stores, running a single test can take 4 to 8 months, making the results obsolete by the time they are finalized.
In contrast, real-time AI adaptation uses millisecond-level reading telemetry. Instead of treating visitors as binary converters or bounces, the AI analyzes behavioral signals like eye-line dwell velocity, scroll deceleration, and friction points. It utilizes continuous multi-armed bandit optimization to automatically scale winning copy variants on live traffic. The trade-off is that traditional testing offers high statistical certainty but is too slow for modern web environments, while AI adaptation offers rapid, behavioral insights but requires trust in the AI's autonomous decision-making. Ensuring the verification handshake is active is the prerequisite for this advanced AI testing to function.
Caching, CDN, and Client-Side Blocks
If you use a Content Delivery Network (CDN) like Cloudflare or server-side caching, the browser might be serving an old version of the page that lacks the latest SeaText script. Clear your site cache and your CDN cache to ensure the most recent version of your code is being served to visitors. Additionally, browser extensions, particularly ad-blockers and privacy-focused tools, often identify tracking scripts as advertisements.
If the verification fails for you but works for others, it is likely a local client-side block. Test the page in an Incognito or Private window with all extensions disabled. If it works there, you will need to whitelist your site within your ad-blocker settings.
Limitations and Exceptions
SeaText verification will not work on 'localhost' or restricted development domains due to security protocols. Additionally, if your page is behind a password protection or a login wall, the AI agents may be unable to crawl the content properly for SEO optimization purposes. Ensure the page is accessible via a valid, real domain for best results. Each SEATEXT AI account is linked to a single primary URL, so if you use multiple domains, you must create separate accounts for each to ensure data integrity.
FAQ
How long does it take for verification to show in the dashboard?
It usually takes 5 to 10 minutes for the website name to appear in the dashboard after the script is correctly installed. However, the AI remains inert until a visitor stays on the page for at least 40 seconds to trigger the activation handshake.
Do I need a separate account for every domain?
Yes, if you are using multiple domains (e.g., a staging and a production site), you must create separate accounts for each to ensure data integrity. Each SEATEXT AI account is linked to a single primary URL.
How does the Bot Refund Agent use the telemetry from the verification?
The Bot Refund Agent uses the telemetry stream to detect bot clicks in real-time. It records forensic click evidence and automatically prepares refund-ready reports for Google and Meta. Without a successful verification, the agent cannot collect this evidence, preventing you from recovering up to 20% of your ad spend.
What if my CSP is managed by a third-party security plugin?
Open your security plugin's settings and locate the Content Security Policy section. Add the SeaText script and connect domains to the whitelist under the script-src and connect-src directives. If you cannot find these specific options, check with the vendor for advanced configuration documentation.
Feature
Common Cause
Action
Script Loading
Script is missing from HTML code
Check header plugin settings
CSP Block
Strict security headers
Whitelist SeaText domains in CSP
Targeting Error
URL pattern mismatch in dashboard
Adjust experiment targeting rules
Caching
Old version of page is served
Clear server and CDN cache
Further reading and comparison sources
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
Further reading and comparison sources
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
What to Do When SeaText Changes Aren't Saving to WeeblyLearn more about this serviceSee how this page can help with your next step.
What to Do When SeaText Changes Aren't Saving to Weebly