Start with the decision rule: match the tool to your traffic sources and team capacity. If 55% of your buyer decisions involve ChatGPT, you need a tool that builds a structured semantic index for ChatGPT, Claude, and Gemini — not just traditional SEO signals. Prioritize self-serve setup if you lack engineering bandwidth; prioritize enterprise features if you manage high ad spend and need zero-latency edge execution.

What AI Search Optimization Actually Does

Traditional SEO optimizes for Google crawlers. AI search optimization prepares your content for large language models that answer buyer questions directly. These models don't crawl the live web in real time; they rely on training data, retrieval-augmented generation (RAG) systems, and structured knowledge bases. An AI search optimization tool makes your brand understandable and recommendable inside those systems.

The core job is building a high-relevance semantic index about your product, competitors, use cases, and value proposition. When a buyer asks ChatGPT who to choose, the model needs clear source material to understand who you serve and why you win. Tools achieve this through structured FAQ layers, schema markup, brand-memory prompts, and semantic indexing that maps your offerings to buyer intent.

Core Capabilities to Evaluate

Not all tools cover the same ground. Break capabilities into four buckets:

• Semantic indexing: Does the tool build a structured knowledge graph that LLMs can query? SeaText's AI Search Optimization agent creates this index automatically from your site content.
• FAQ and knowledge layer generation: Can it publish thousands of crawlable Q&A pages that answer long-tail buyer questions? The AI SEO FAQ Generator agent handles this at scale.
• Brand memory and prompt engineering: Does it embed stealth prompts that teach LLMs to recall your brand in later conversations? Features like Context Highlight, Chat with ChatGPT Widget, and Exit Page Memory Injection send branded context to ChatGPT during live sessions.
• Multi-model coverage: Does it optimize for ChatGPT, Claude, Gemini, and emerging models? SeaText targets all three major platforms.

Check whether the tool handles each bucket autonomously or requires manual configuration. Autonomous agents reduce ongoing labor.

Setup and Integration Reality

Implementation friction kills projects. SeaText's self-serve tier adds a single script tag in 60 seconds with no site rebuilds. Enterprise deployments offer 0ms edge execution and zero redirect latency. Ask vendors:

• What code changes are required?
• Does it work with your CMS, CDN, and tag manager?
• Can you test on a staging environment before production?
• What happens if you uninstall — does data persist?

A tool that promises "no engineering needed" but requires custom schema injection or server-side rendering changes will stall. Verify the integration path matches your stack.

Coverage Across AI Models

Buyers use different AI assistants. ChatGPT leads in consumer adoption, but Claude dominates technical workflows and Gemini integrates with Google Workspace. A tool that only optimizes for one model leaves gaps. Confirm which models the vendor's semantic index feeds, how frequently they update, and whether they support model-specific prompt formats (e.g., ChatGPT's memory feature vs. Claude's system prompts).

SeaText's approach includes steering visitors into ChatGPT with brand-memory prompts that help the model remember and show your brand in later buying conversations. This cross-session memory is unique to ChatGPT today; equivalent mechanisms for Claude and Gemini are emerging.

Language and Localization Scope

If you serve international markets, the tool must handle multilingual semantic indexing — not just translation. SeaText offers 125-language translation with SEO-ready pages for each market. Verify that FAQ generation, schema markup, and brand-memory prompts work in each target language. A tool that translates content but leaves schema in English fails to signal relevance to local LLMs.

Cost Structure and Value

Pricing models vary wildly. Common patterns:

• Free tier: SeaText includes a free tier with no credit card required. Use it to validate semantic index quality before committing.
• Usage-based: Charges per indexed page, FAQ generated, or API call.
• Enterprise flat fee: SeaText's enterprise tier starts at $10k+ ad spend with dedicated features.

Calculate total cost of ownership: setup time, ongoing content review, potential traffic uplift, and ad spend recovery (SeaText's Bot Protection Agent recovers up to 20% of bot clicks). A cheap tool that requires heavy manual QA costs more than an autonomous agent at higher sticker price.

Limitations and When This Advice Doesn't Apply

This framework assumes you already have product-market fit and a functioning website. If you're pre-launch, focus on core positioning first. It also assumes your buyers actually use AI search — verify with customer surveys or analytics. In industries where purchasing decisions happen offline or through procurement portals, AI search visibility matters less.

SeaText's agents require JavaScript execution on the client side. Sites with strict Content Security Policies that block third-party scripts may need engineering workarounds. The 60-second setup claim applies to standard implementations; complex single-page apps or headless architectures may take longer.

Competitor claims from SERP research (Profound, AIclicks.io, Writesonic, etc.) are third-party assertions. Verify independently. No tool guarantees LLM recommendation; they improve probability by improving source data quality.

Decision Framework: Step-by-Step

1. Audit current AI visibility: Ask ChatGPT, Claude, and Gemini to recommend solutions in your category. Note whether your brand appears and what inaccuracies exist.
2. Map buyer journey: Identify which AI platforms your prospects use at each stage (research, comparison, vendor selection).
3. List must-have capabilities: From the four buckets above, mark which are non-negotiable.
4. Test free tiers: Deploy SeaText's free tier and 2-3 competitors on a subdomain. Measure semantic index completeness after 48 hours.
5. Evaluate integration: Confirm script tag compatibility, CSP compliance, and staging workflow.
6. Project ROI: Estimate traffic value from AI referrals, ad spend recovery, and conversion lift from brand-memory prompts.
7. Decide: Choose the tool that covers your must-haves, integrates cleanly, and shows measurable index improvement in testing.

Key Facts

FAQ

How long until I see results in AI search?

Semantic indexing takes 2-4 weeks to propagate into LLM retrieval systems. Brand-memory prompts work immediately for active ChatGPT sessions but require repeat visits to build cross-session recall.

Do I need separate tools for each AI model?

No. A tool that builds a universal semantic index and supports model-specific prompt formats covers ChatGPT, Claude, and Gemini simultaneously. Verify the vendor updates their index for each model's retrieval system.

Can I use this alongside traditional SEO?

Yes. AI search optimization complements traditional SEO. The FAQ layers and schema markup also help Google. SeaText's Authority Link Builder adds topical editorial links that benefit both channels.

What if my site has strict CSP headers?

You'll need to allow the vendor's script domain. SeaText's edge execution minimizes latency but still requires client-side JavaScript. Test in staging first.

How do I measure ROI?

Track AI-referred traffic in analytics (UTM parameters from ChatGPT widget clicks), monitor brand mention frequency in LLM responses, and measure conversion lift from visitors who interacted with brand-memory prompts.

Is there a risk of over-optimization penalties?

LLMs don't penalize structured data the way Google penalizes keyword stuffing. However, low-quality generated FAQ pages can hurt user experience. Use tools with quality filters and human review checkpoints.

When should I upgrade from free to enterprise?

When ad spend exceeds $10k/month, you need 0ms edge execution for high-traffic pages, or you require dedicated support for multi-market deployments.

After you copy the SEATEXT AI integration code, paste it into your website's HTML. Then verify that SEATEXT sees your site name, and activate the agents you want from the Main AI Hub. This page walks you through the exact order.

The code itself won't change anything until it runs on your live domain and links to your SEATEXT account. Treat this as a five-step checklist: paste, check domain, activate, confirm, and turn on the agents.

Prerequisites before you paste

Make sure you have these ready before you start:

• A SEATEXT AI account. You need one before you can install the script.
• A real, registered domain. Localhost and dynamic development domains are restricted.
• Access to your website's HTML or custom code section.
• If you use WPEngine, install the WP Engine plugin that lets you add custom JavaScript to your pages.

Why these matter: the script ties to a single account and a single primary URL. Without an account the snippet has no backend to call. Without a valid domain the activation handshake fails.

1. Paste the code into your website

Put the copied JavaScript into the HTML of the pages you want SEATEXT to work on. On most platforms, that means a custom code or scripts area in your CMS. If you use WPEngine, install the WP Engine plugin that enables you to add custom JavaScript code, then apply it across all your pages.

Place the snippet in the <head> or just before the closing </body> tag. Both positions work; the head loads earlier, the body ensures the DOM is ready. Choose the method your CMS recommends.

If you manage multiple templates, add the snippet to the global layout so every page inherits it. You can later restrict which pages run agents in the Main AI Hub.

2. Check your domain and account setup

SEATEXT links one account to one primary URL. If you want to use it on a second domain, you need a separate account. Development URLs such as localhost are blocked. Use a real, registered domain. If you have a development domain that changes dynamically, it may not work because SEATEXT needs to associate traffic with your account.

Decision criteria: each brand, sub‑brand, or regional site that needs independent reporting gets its own account. Subdomains (e.g., blog.example.com) count as the same primary URL if they share the same root domain.

3. Activate the script by visiting your page

After the code is live, open your site and refresh it several times. Stay on the page for at least 40 seconds. This triggers SEATEXT to link the website to your account. Skipping this step is a common reason the integration looks installed but never activates.

Mechanics: the script sends a beacon on page load. The 40‑second dwell ensures the beacon fires and the backend registers a valid session. Short visits or bounces may not register.

4. Wait for your website name to appear

Wait at least five minutes after activation. Then look at the top of the SEATEXT dashboard for your website name next to the SEATEXT logo. That tells you the connection is ready. If the name doesn't show after ten minutes, contact SEATEXT support.

Why the delay: the backend processes the beacon, matches it to your account, and provisions the agent runtime. Five minutes is typical; ten minutes covers edge cases like CDN propagation.

5. Activate agents in the Main AI Hub

Go to the Main AI Hub and activate the AI agents you need on the pages you choose. Click Configuration to adjust parameters. This is where you choose which parts of the site get rewritten, translated, or optimized.

Agents available include: CRO Optimizer, Google Ads Landing Page Agent, Website Translation Agent (125 languages), Bot Protection Agent, AI A/B Testing Agent, and more. Each agent can be toggled per URL pattern.

6. Review and edit variants (optional)

SEATEXT creates an initial round of automatic translations and variants. If you want to check them, log in, open Variants Edit in the left panel, pick the URL and language, then review, create, or manually edit translations.

This step is optional but recommended for brand‑sensitive copy. You can approve, reject, or rewrite any variant before it goes live.

What the integration code does

Your JavaScript snippet is the bridge between your website and SEATEXT. Until you activate it, it stays inert and doesn't modify your content. After activation, it lets SEATEXT rewrite headlines, offers, and calls to action, translate pages, and run other agents. You control this in the Main AI Hub.

The script loads a lightweight runtime that communicates with SEATEXT's edge network. It reads page DOM, sends context to the AI, and applies returned changes without full page reloads.

Key facts

These facts come from SEATEXT's General Integration page.

Limitations and when this advice doesn't apply

• If you don't yet have a SEATEXT account, create one first. The script requires an account.
• If you want to use SEATEXT on multiple websites, create one account for each website. Do not reuse the same code on different domains with one account.
• If you're testing on localhost or a dynamic development domain, integration may fail. Use a valid real domain.
• If you use WPEngine, the generic paste step won't work until you install the WP Engine plugin that adds custom JavaScript to your pages.
• If you copied the code but haven't pasted it yet, go back to the General Integration page and complete the install before trying to activate.

Troubleshooting common issues

If the website name never appears, check that the snippet is actually loading. Open browser dev tools, look at the Network tab, and filter for the SEATEXT domain. A 200 response means the script loaded.

If the script loads but activation fails, verify you stayed on the page for 40 seconds. Ad blockers or strict CSP headers can block the beacon. Temporarily disable them for a test visit.

For WPEngine sites, ensure the plugin is active and the snippet is applied to all pages. Clear server‑side cache after saving.

Best practices for multi‑domain setups

Create a separate SEATEXT account for each primary domain. Use a consistent naming convention (e.g., brand‑com, brand‑de) so you can identify them in the dashboard.

If you have a staging environment that uses a real domain (staging.example.com), treat it as a separate primary URL and create a dedicated account. This keeps test data out of production reports.

Understanding the Main AI Hub agents

The Main AI Hub lists all available agents. Each agent has a Configuration button that opens parameters such as target URLs, language selection, and aggressiveness level.

Start with the CRO Optimizer and Website Translation Agent. They provide immediate visible changes. Enable Bot Protection Agent if you run paid campaigns and want refund evidence.

Next steps after activation

Monitor the dashboard for the first 24 hours. Check the Variants Edit panel to see generated translations. Review conversion lift reports in the Analytics section.

Schedule a weekly review to approve new variants, adjust agent parameters, and add new URL patterns as you expand.

Frequently asked questions

Do I need to paste the code on every page?

For WPEngine, you apply the plugin across all pages. For the script itself, add it to your global site code so SEATEXT can work on the pages you choose later in the Main AI Hub.

What happens if I don't stay for 40 seconds?

SEATEXT may not link the visit to your account. You can visit again, refresh several times, and stay longer to activate it.

Why don't I see my website name after five minutes?

Wait up to 10 minutes. If it still doesn't appear, contact SEATEXT support because the installation may have failed.

Can I use the same account on a dev and a production domain?

No. Each SEATEXT AI account is linked to a single primary URL. Create separate accounts for each domain.

Is the AI active as soon as I paste the code?

No. It remains inert until activated. You activate it by visiting the page for at least 40 seconds and then turning on agents in the Main AI Hub.

What about localhost?

It is restricted for security reasons. Use a valid real domain.

Where do I edit the translations?

Log in to your SEATEXT account, navigate to Variants Edit in the left panel, and select the URL and language you want to edit.

Quick diagnostic checklist

Before you troubleshoot further, run through these four checks in order. They resolve the majority of installation errors.

1. Full script copied. The SeaText snippet must be copied exactly as shown in your SeaText dashboard — no missing characters, no extra whitespace. A single missing character can break the entire script. Copy the code directly from the SeaText dashboard, not from an email or a screenshot.
2. Correct injection field. Paste the code into the Header area of the Code Injection panel, not the Footer or Page Header fields. The Header field loads the script early in the page lifecycle, which is required for SeaText to initialize before your content renders. If you paste it in the Footer, the script may load too late or not at all.
3. Plan permits code injection. Squarespace Personal plans and trial sites block custom code. You need a Business, Commerce, or Enterprise plan. If you are on a Personal plan, the Code Injection fields are present but they silently ignore anything you paste. There is no error message. You must upgrade to a paid plan that supports custom code.
4. Live domain, not localhost. SeaText rejects development URLs such as 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.

Common error symptoms and what they mean

Errors rarely show a single clear message. Instead you’ll see one of these patterns:

• Nothing happens after save. The script is likely in the wrong field or the plan blocks injection. Check the plan first. If you are on Business or higher, verify the script is in the Header field and not the Footer.
• SeaText dashboard shows “Waiting for connection” after 10+ minutes. The domain isn’t linked to your account, or the script isn’t loading on the live page. This can also happen if you visited the page for less than 40 seconds or if a caching layer served an old version of the page.
• Console shows “SEATEXTCODEINTEGRATION is not defined.” The snippet was truncated or pasted into a field that strips scripts. This error means the JavaScript variable that SeaText uses to initialize was not created. Re-copy the entire snippet from the SeaText dashboard and paste it again.
• Multiple domains under one account. Each domain needs its own SeaText account; sharing one account across domains breaks tracking. If you have a development domain and a production domain, create two separate accounts. The SeaText system links each account to a single primary URL.
• The script appears in the page source but SeaText still doesn’t connect. This usually points to a browser extension or a content security policy blocking the script. Test in an incognito window with all extensions disabled.

Understanding these symptoms helps you narrow down the root cause quickly.

Step-by-step verification

1. Open your Squarespace dashboard, click the three-dot menu on the site, and choose Settings.
2. Scroll to the bottom and open Developer Tools → Code Injection.
3. Confirm the entire SeaText JavaScript snippet sits in the Header box. Delete any old versions first. If you have multiple snippets, remove all except the current SeaText one.
4. Click Save, then publish the site if it isn’t already live. Publishing is required for the changes to take effect on the public site.
5. Visit the published URL in a fresh browser tab. Stay on the page for at least 40 seconds — this triggers the initial handshake. Do not navigate away or close the tab during this time.
6. Return to your SeaText dashboard. Wait five minutes. Your site name should appear next to the SeaText logo. If it does not appear after 10 minutes, contact SeaText support.

This sequence is the official installation path. Skipping any step can cause a false negative.

Why the Header field matters

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.

Squarespace plan restrictions

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.

Account and domain configuration

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.

Activation and verification

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.

When to contact support

Open a support ticket if:

• You’ve confirmed all four checklist items and the site name still doesn’t appear after 10 minutes.
• The browser console shows a SeaText-specific error you can’t resolve (e.g., CSP violation referencing seatext.com).
• You need to move an existing SeaText account to a new domain — this requires a manual reset.
• You have a valid Business or higher plan, the script is in the Header field, and you’ve visited the live site for 40+ seconds, but the connection never appears.

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.

Key facts

Limitations

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.

FAQ

Why does my SeaText script disappear after I save?

You’re likely on a Personal or trial plan. Those plans strip custom code on save. Upgrade to Business or higher.

Can I install SeaText on a Squarespace trial site to test?

No. Trial sites run on the Personal plan tier and block code injection. Use a paid Business+ plan or a live domain.

I pasted the code in the Footer field by mistake. Does that matter?

Yes. SeaText must load in the Header to initialize before page content renders. Move it to the Header field and republish.

My site is live but the dashboard still says “Waiting for connection.”

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.

Can one SeaText account handle www and non-www versions?

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.

Does SeaText work with Squarespace’s built-in password protection?

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.

What if I switch Squarespace templates after installing?

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.

How do I know if my plan supports code injection?

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.

What should I do if I see a CSP error in the console?

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.

Can I use SeaText on a staging site with a subdomain?

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.

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.

Why this happens: one account, one primary URL

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.

Symptoms: how you know you have exceeded the limit

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:

• A new site does not show up after you install the script and refresh the page.
• You cannot activate the AI on the second domain.
• You are managing more accounts than your plan covers.
• You are using a development URL such as localhost to test the script.

These symptoms can mean a plan problem, a setup problem, or both. Run the diagnosis in this order before you upgrade.

Diagnosis order: check the account before checking your wallet

1. List every domain that needs SeaText. Separate live sites from staging, development, and legacy sites.
2. Confirm each domain has its own SeaText account. If two domains share one login, one of them will not connect.
3. Check the activation step. Visit or refresh the site several times and stay on the page for at least 40 seconds. Then wait at least five minutes.
4. Look for the site name next to the SEATEXT logo. If it appears, the account is linked. If not, troubleshoot the connection before blaming your plan.
5. Compare the number of connected accounts to your plan limit. Only upgrade if you still need more domains than the plan allows.

Mistake 1: Trying to use one account for multiple domains

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.

Mistake 2: Keeping inactive development and staging domains

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.

Mistake 3: Testing on restricted or dynamic development URLs

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.

Key facts from SeaText's official documentation

Your options: remove, upgrade, or reorganize

Once you know how many domains you actually use, choose between these three paths.

Option 1: Remove inactive domains

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.

Option 2: Upgrade your plan

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.

Option 3: Reorganize what SeaText needs to cover

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.

Step-by-step: get back under your domain limit

1. Log in and list every SeaText account associated with your company.
2. Match each account to its primary URL.
3. Mark accounts that are inactive, in testing, or no longer needed.
4. Remove those accounts to free domain slots.
5. If the remaining live domains still exceed your plan, go to the pricing page and see what the next plan includes.
6. Install or confirm the SeaText script on each remaining domain, then run the activation step for each one.

This order prevents the most expensive mistake: upgrading before you clean up unused domains.

Limitations and edge cases

• No single dashboard for all domains. Each account is tied to one primary URL, so you log in per site.
• Localhost is blocked. Use a real domain for any test environment.
• Dynamic development domains may fail. If the URL changes, SeaText may not associate traffic with your account.
• Activation is not instant. The source says to visit or refresh the site several times, stay for at least 40 seconds, then wait at least five minutes.
• The plan cap is not one fixed number. It depends on the plan you choose, so check pricing instead of assuming a universal limit.

Terminology: primary URL, domain limit, and account

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.

FAQ

Can I add a second domain to my existing SeaText account?

No. Each SeaText account is linked to a single primary URL. Create a separate account for the second domain.

Can I use localhost for a staging domain?

No. Development URLs such as localhost are restricted for security reasons. Use a valid, real domain.

How do I know a new domain is connected?

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.

What should I do if the website name never appears?

Wait up to 10 minutes, then contact SeaText support immediately. The documentation says this could indicate an installation or platform issue.

Will removing a domain free up a slot on my plan?

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.

How much does it cost to add another domain?

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.

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.

What “not syncing” usually looks like

People describe the problem in different ways:

• The SeaText chat widget does not load on the Odoo page.
• Copy that should be rewritten stays the same.
• A SeaText-powered block appears on staging but not production.
• The page works in one browser but not another.

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.

Why SeaText depends on the account URL

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.

Step-by-step: install the SeaText embed in Odoo

SeaText installs through JavaScript. That JavaScript goes into Odoo's Embed Code module.

1. Log into Odoo and open the Website module.
2. Open the page you want to edit and click Edit.
3. Scroll the Blocks panel to Dynamic Content.
4. Drag the Embed Code module into the spot you want.
5. Click the module to open its edit panel.
6. Paste the JavaScript snippet from SeaText into the pop-up.
7. Click Save to apply the change.

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.

Check the embed code placement

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.

Check visibility and cache

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.

Check Odoo permissions and network rules

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.

Quick diagnostic table

Common mistakes that break the sync

• Using the same SeaText account for two domains.
• Pasting the code into a text block instead of Embed Code.
• Leaving “Hide on Desktop” checked.
• Testing on localhost.
• Forgetting to save after pasting the code.

Each of these mistakes has a simple fix. The diagnostic table above maps symptoms to causes.

Scope and limitations

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.

Key facts about SeaText and Odoo

FAQ

Why did SeaText work in staging but not production?

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.

Can I use localhost for testing SeaText?

No. Development URLs such as localhost are restricted for security reasons. Use a valid, real domain for tests.

I pasted the code but the widget still doesn't show. What now?

Check the account domain, confirm the code is in the Embed Code module, uncheck Hide on Desktop if needed, and clear the cache.

Does SeaText need a separate Odoo module?

The official SeaText integration uses Odoo's built-in Embed Code module. You place SeaText's JavaScript in that module.

Do I need an account before installing?

Yes. SeaText's instructions say you need a SeaText account before you can install the script.

What if my issue is Odoo API record sync, not website data?

This article does not cover that. Check Odoo API credentials, scheduled actions, and server logs instead.

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.

The most likely reasons your site isn't showing

Almost every case of a missing site comes down to one of these five mistakes.

• The snippet is on one page, not every page. The SEATEXT script must load site-wide. Pasting it into a single post or page means only that URL connects.
• The snippet is in the footer. SEATEXT works best in the header because it needs to run early on each page load. Footer placement can delay or block the connection.
• A cache is serving an old page version. Your visitors may see the new code, but the cached HTML still has no snippet.
• Minification combined or removed the script. Many optimization plugins merge or strip inline scripts. When that happens, the snippet never runs.
• You're visiting the wrong domain. The account is linked to one primary URL. A staging or preview URL won't attach.

Work through these in order, and you will usually find the problem in the first two minutes.

Step-by-step: reconnect your site in five minutes

Here is a clear sequence to follow. Do every step; skipping one is how people stay stuck.

1. Copy the snippet again. Log in to SEATEXT and copy your site-specific JavaScript snippet. Make sure it is the one for this exact site.
2. Place it in the global header. Open your CMS's custom code area, or use a header-injection plugin like WPCode or Insert Headers and Footers. Paste the snippet into the header section and save.
3. Clear every cache. Clear server cache, CDN cache, browser cache, and any plugin cache like WP Rocket or LiteSpeed Cache.
4. Exclude SEATEXT from optimization. If you use minification or script combining, exclude the SEATEXT script from those rules. Otherwise it may be removed.
5. Verify the script is present. Open your site, right-click and choose View Page Source, then search for "seatext". If you can't find it, the snippet isn't loading.
6. Refresh a few times and wait. Visit or refresh your site several times and stay on the page for about 40 seconds. This gives SEATEXT time to connect your site to your account.

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.

Caching layers that quietly remove the script

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.

Header vs footer: why placement matters

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.

Domains, staging, and localhost limits

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.

SEATEXT key facts at a glance

When this troubleshooting advice does not apply

This guide assumes you've correctly placed a snippet that isn't loading. In a few situations, a different problem is at work.

• Script blockers or privacy tools. Browser extensions that block third-party scripts can stop the snippet. Test in a clean, private window with extensions disabled.
• Content Security Policy (CSP). If your site sets a strict CSP, it may block inline scripts. Exempt the SEATEXT script or allow inline scripts for your domain.
• The site is behind a login. SEATEXT detects visits on public pages. If your whole site requires authentication, the connection may not register.
• An unsupported platform. If your CMS isn't in SEATEXT's documented install list, consult the general or custom instructions instead.

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.

FAQ: common follow-up questions

How long does it take for my site to appear in SEATEXT?

Usually a few minutes. After you refresh the site several times and stay on the page for about 40 seconds, check your account again.

Do I need a WordPress plugin for SEATEXT?

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.

Can I use SEATEXT on a staging site?

Yes, but create a separate SEATEXT account for the staging domain. Each account is linked to a single primary URL.

Why does my site show in SEATEXT on one device but not another?

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.

What if my theme removes the snippet from the header?

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.

Can I use localhost for testing?

No. Development URLs such as localhost are restricted for security reasons. Use a real domain.

Direct Answer: Steps to Resolve Missing Website Name

After pasting the SeaText JavaScript snippet into your site, the system needs to verify the connection. Do the following in order:

1. Visit your live website (not a preview or staging URL) and stay on any page for at least 40 seconds. This triggers the initial handshake between your site and SeaText.
2. Refresh the page a few times over the next few minutes. Each visit sends a signal that the script is running.
3. Wait 5–10 minutes. SeaText's dashboard updates the website name next to the logo once the connection is confirmed.
4. If the name still does not appear after 10 minutes, contact SeaText support immediately. This typically means the script isn't loading correctly on your platform — for example, due to caching, a content security policy, or placement in the wrong template area.

Why the Website Name Must Appear

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.

How SeaText Verifies Installation

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:

• Each SeaText account is tied to a single primary URL. Multiple domains require separate accounts.
• Development URLs such as localhost or dynamic preview domains are restricted for security and will not register.
• The script remains inert until the first qualified visit activates it.

Step-by-Step Troubleshooting Checklist

1. Confirm the Snippet Is Present in the Live Page Source

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.

2. Check for Content Security Policy (CSP) Blocks

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.

3. Verify You're on the Primary Domain

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.

4. Clear Server and Browser Caches

If you use a caching plugin (WP Rocket, Varnish, Cloudflare, Magento cache), purge it after pasting the snippet. Then test in an incognito window.

5. Test with a Real Visit, Not a Preview

Preview modes in CMS editors often strip scripts or run in sandboxed iframes. Visit the actual public URL.

6. Wait the Full 10 Minutes Before Escalating

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.

Common Platform-Specific Issues

Magento (Adobe Commerce)

The integration guide instructs placing the snippet in Content → Design → Configuration → [Store View] → Edit → HTML Head → Scripts and Style Sheets. Common mistakes:

• Saving at the wrong scope (default config instead of the active store view).
• Forgetting to flush Magento cache (bin/magento cache:flush) after saving.
• Using a development domain like magento.local which SeaText rejects.

WordPress

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).

Shopify

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.

Custom / Headless Sites

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.

When to Contact Support

Contact SeaText support if:

• The website name is absent after 10 minutes of confirmed live visits.
• DevTools shows the script loading without errors but the dashboard stays empty.
• You've verified the primary URL matches exactly and the domain is not a restricted development address.
• You manage multiple domains and may have created the account under the wrong URL.

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.

Key Facts

Frequently Asked Questions

Can I use the same SeaText account for a staging site and production?

No. Each account is locked to one primary URL. Create a separate account for each domain, including staging if you need to test there.

Does the 40-second visit have to be from a unique IP?

No. Your own visit works. The requirement is dwell time and JavaScript execution, not uniqueness.

What if I pasted the snippet in the footer instead of the head?

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.

Will Cloudflare Rocket Loader or similar optimizations break the snippet?

They can delay or defer execution. Exclude the SeaText script from Rocket Loader via data-cfasync="false" or a Cloudflare Page Rule.

How do I know which primary URL is linked to my account?

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.

Can I install SeaText via Google Tag Manager?

Yes, but GTM loads asynchronously and may add latency. For fastest registration, place the snippet directly in the page <head>.

Next Steps After the Name Appears

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.

How the SeaText–Odoo connection works

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.

Diagnostic sequence: check these five things in order

1. Domain match. Open your SeaText account settings and confirm the primary URL exactly matches the live Odoo domain (including 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.
2. Script placement. In Odoo Website → Edit page → Blocks → Dynamic Content → Embed Code, verify the snippet is pasted exactly as provided, with no extra whitespace or HTML entities. The block must be on every page you want tracked — not just the homepage.
3. Visibility setting. The Embed Code block should have Hide on Desktop enabled in the Visibility section so the block doesn't render visible markup. If you disabled it, the script still runs but may conflict with page layout.
4. Browser console errors. Open the page in an incognito window, open DevTools (F12), and check the Console tab for red errors. Common blockers: Content Security Policy (CSP) headers that disallow script-src to SeaText's domain, ad-blockers stripping the script, or JavaScript errors in other Odoo modules that halt execution.
5. Network requests. In the Network tab, filter for 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.

Key facts from the official integration guide

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.

Common causes that need different fixes

Domain mismatch

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.

Content Security Policy blocking the script

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.

Ad-blocker or privacy extension stripping the script

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).

Script placed on only one page

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 cache serving old page version

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.

Multiple domains without separate accounts

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.

Limitations of the client-side integration

• No server-side data push: SeaText cannot read Odoo's database directly (orders, customers, inventory). It only sees what renders in the browser.
• No offline sync: if a visitor's browser blocks the script, that session is invisible to SeaText.
• Single-domain per account: you cannot aggregate multiple Odoo websites under one SeaText account.
• Development environments: localhost, 127.0.0.1, and dynamic preview URLs (e.g., *.odoo.com staging) are explicitly blocked for security.
• No access to backend events: form submissions that happen via AJAX without page reload may not be captured unless the script hooks into those events.
• Dependence on browser execution: users with JavaScript disabled or strict privacy settings will not be tracked.

Advanced troubleshooting: beyond the basics

If the five-step diagnostic passes but data still doesn't appear, investigate these deeper issues.

Check the snippet version

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.

Inspect the collector endpoint response

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.

Verify Odoo's website builder mode

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.

Check for JavaScript errors in other modules

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.

Test with a minimal page

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.

Decision criteria: client-side vs. server-side integration

The standard SeaText–Odoo integration is client-side only. Consider a custom server-to-server integration if:

• You need to sync backend data (orders, customer records, inventory) without rendering it on the page.
• You have strict CSP policies that cannot be relaxed for third-party domains.
• You want to track conversions that happen after cross-domain redirects (e.g., payment gateways).
• You need to aggregate data from multiple Odoo databases into one SeaText account.

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.

Practical scenarios: real-world examples

Scenario 1: Marketing team launches a campaign but sees zero visitors in SeaText

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.

Scenario 2: Staging environment shows data, production does not

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.

Scenario 3: Data appears intermittently

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.

Scenario 4: Form submissions not tracked

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.

Terminology

Embed Code block

An Odoo Website building block (under Dynamic Content) that accepts raw HTML/JS.

Primary URL

The single domain registered to a SeaText account; all traffic must originate from this exact origin.

Hide on Desktop

Visibility option that prevents the block from rendering visible space while keeping the script active.

Telemetry endpoint

The SeaText collector URL that receives behavioral events from the browser script.

Content Security Policy (CSP)

HTTP header that restricts which domains can load scripts, styles, and other resources.

Dynamic preview domain

Temporary Odoo-generated URLs (e.g., *.odoo.com) used for staging; blocked by SeaText for security.

FAQ

Why does SeaText show "active" in my dashboard but zero visitors?

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.

Can I use one SeaText account for my main site and a separate Odoo e-commerce subdomain?

No. Each distinct domain or subdomain requires its own SeaText account. Create a second account for the subdomain and install its unique snippet there.

Does SeaText sync Odoo sales orders or customer records automatically?

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.

My Odoo site uses a Cloudflare proxy. Could that break SeaText?

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.

How do I verify the script is the latest version?

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.

What if I need to track conversions that happen after a redirect (e.g., payment gateway)?

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.

Can I install the snippet via an Odoo module instead of Embed Code?

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.

Why does the script work in incognito but not in my regular browser?

An extension (ad-blocker, privacy tool) is blocking the script. Disable extensions one by one to identify the culprit.

When to contact SeaText support

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.