Separate accounts provide clear data separation, independent billing, and avoid cross-domain analytics mixing, but they require more management. If you run more than one website, you need to decide how to structure your SeaText setup. The tradeoff table below shows the main differences at a glance.

Choose separate accounts if you need clean data per domain, client billing, or security isolation. There is no single-account option for multiple domains. SeaText forces separate accounts to protect your data and keep analytics honest.

Why SeaText requires one account per domain

SeaText links each account to a single primary URL. This is a core design choice, not a limitation you can bypass. When you install the SeaText script on a website, all data from that URL is associated with that account. The system needs to know which domain generated which action. If the same script were used across multiple domains, the system could not reliably attribute events. The result would be messy data, inaccurate reporting, and potential security gaps.

SeaText's own integration instructions are clear: if you need to use SeaText on multiple domains, you must create separate accounts for each domain. This applies to production sites, staging sites, client sites, and any other website you run. The rule exists to keep data trustworthy.

What counts as a separate domain

A primary URL is the main domain or subdomain where you install SeaText. The account is locked to that URL. Different top-level domains, such as example.com and example.org, are clearly separate. Subdomains are also treated as separate domains in most cases. That means blog.example.com and shop.example.com each need their own account if you want to track them separately. The same logic applies to staging and development domains. A staging site at staging.example.com is not the same primary URL as example.com. You should plan for one account per distinct URL.

Development URLs such as localhost are restricted for security reasons. Dynamic development domains may also fail to work properly because SeaText might not be able to reliably associate traffic with your account. Use a valid, real domain for any environment you want to connect to SeaText.

Benefits of separate accounts in practice

Separate accounts create clear boundaries. Each domain's visitor data, conversion metrics, and agent behavior stay in its own workspace. This makes it easier to trust what the data says.

Clean data per domain

When you run separate accounts, each domain's conversion data, traffic sources, and agent performance are isolated. You can see exactly how one agent performs on your ecommerce site versus your blog. No cross-contamination. This matters for SeaText's AI agents because they make decisions based on domain-specific data. The CRO optimizer learns from visitors on one site. The translation agent works on one site's content. If all data were mixed, the agents could receive confusing signals.

Independent billing

Each SeaText account has its own billing. If you manage multiple client sites, you can give each client their own invoice. You can also track costs per site without building custom spreadsheets. For internal teams, separate accounts let you budget per project. Independent billing is one of the easiest ways to answer the question: how much does this website cost?

Security isolation

Separate accounts limit the blast radius of a security problem. If one account's credentials are compromised, the attacker cannot access your other domains. This is especially important when a development site has weaker security or when many team members share logins. A breach in a staging account should not put your production site at risk.

Accurate analytics

SeaText's agents rely on domain-specific data to make decisions. Accurate analytics matter because the agents adapt headlines, offers, product blocks, and calls to action. If data from two domains were mixed, the agent might optimize for the wrong audience. Separate accounts keep conversion reporting clean. You know which page, keyword, and version drove the result.

When separate accounts add overhead

The main downside is management effort. You need to log into each account individually. You also need to activate agents per domain and monitor separate dashboards. For many domains, that can become time-consuming. The setup is quick, though. Installation takes under one minute per domain. You copy one JavaScript snippet and paste it into the theme files. For Shopify, you edit theme.liquid and save the change. The repetitive work is small, but daily management can add up.

Another source of overhead is agent configuration. Each account needs separate activation of the agents you want. You might also need to set different goals for each site. That is not difficult, but it is more work than a single dashboard would be. If you only have one domain, none of this overhead applies. One account is all you need.

Decision criteria: when separate accounts fit best

Separate accounts are mandatory for multiple domains. That is the main decision criterion. If you have more than one primary URL, you do not really have a choice. But within that rule, separate accounts fit some situations better than others. Use them when you need per-client reporting, especially if you run an agency. Use them when you need to keep staging and production separate. Use them when different domains have different goals, audiences, or compliance requirements.

Separate accounts also make sense when one site is experimental. A dev site may get unusual traffic. You may run tests that should not affect production data. Keeping that environment in its own account protects the production dataset.

The main limitation is visibility. SeaText does not currently offer a multi-account dashboard. You log into each account separately. If you need a unified view across many client sites, you may need to build your own reporting layer or use separate exports. Check with the vendor about any future multi-account features.

Key facts about SeaText accounts and domains

Limitations and when the advice doesn't apply

If you have only one domain, you do not need separate accounts. One account gives you all the data you need. The advice about separate accounts applies only when you have multiple domains.

Another exception: if you have a single domain but want to separate data by campaign or language, separate accounts won't help. SeaText accounts are tied to a primary URL, not to campaigns. Instead, you would need to use segmentation features within a single account. Check with the vendor for details on available segmentation options.

Subdomains can be a gray area. In many setups, each subdomain is treated as a separate domain. Before you install on blog.example.com and example.com, verify how SeaText handles that pair. The safest approach is to use separate accounts for separate primary URLs.

Account linking is not available. You cannot merge accounts or link them to share data. If you create the wrong structure at the start, the fix is usually to create a new account. That makes early planning important.

How to set up separate accounts without friction

Start by listing every domain you need to track. Include production, staging, client, and test sites. Then create one SeaText account for each. Use a clear naming convention so you can tell accounts apart. For example, use the domain name in the account profile.

Keep credentials organized in a password manager. If you manage client accounts, use separate email addresses or aliases where needed. After creating the accounts, install the script on each domain. Give each account its own installation snippet. Do not copy the same snippet to multiple sites. If you do, SeaText cannot reliably associate data with the correct account.

Activate only the agents you need in each account. A staging site may not need the same agents as production. This keeps costs down and reduces noise in the data.

Frequently asked questions

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

No. SeaText requires separate accounts for each domain, including staging and production. Use a separate account for your staging domain and another for your live site.

What happens if I try to install the same script on a second domain?

The script will not work correctly. SeaText's account is linked to a single primary URL, so data from the second domain won't be tracked or attributed to your account. You must create a new account.

Is there a way to manage multiple accounts from one dashboard?

Currently, SeaText does not offer a multi-account dashboard. You log into each account separately. However, the process is straightforward and each account's dashboard is clear.

Do separate accounts cost more?

Yes, each account has its own billing. You pay for each domain separately. This can increase total cost, but it also gives you granular cost tracking per site.

Can I change the primary URL of an existing account?

Check with SeaText support. Typically, the primary URL is set at account creation and cannot be changed. It is easier to create a new account for a new domain.

What about subdomains like app.example.com?

Subdomains are treated as separate domains in most cases. If you want to track app.example.com separately from www.example.com, you need separate accounts.

Running SeaText AI on multiple Shopify domains can create confusion. The most common problem is using one SeaText AI account for more than one domain. That setup is not supported. Each account is linked to a single primary URL. You need a separate account for each domain. You also need to avoid restricted development URLs such as localhost. And you need to track multiple accounts and billing carefully. This article explains the common problems, why they happen, and how to fix them.

The One-Account Mistake (Most Common Problem)

Many store owners try to use the same account on a live store and a development store. For example, you have mystore.com and dev.mystore.com. If you install the same SeaText AI code on both, the AI may not work reliably. SeaText AI links each account to one primary URL. When the script appears on another domain, the system may not be able to associate traffic with your account.

Symptom: The AI agents do not activate on one or both domains.

Diagnosis: Check which domain is set as the primary URL for the account. Then compare it with the domain that has the script installed.

Solution: Create a separate account for each domain. Install the script from that account only on that domain.

How to Create Separate SeaText AI Accounts Step by Step

Step 1: Create one account per domain

Go to the SeaText AI website and create an account for the first domain. Then create another account for the second domain. Do not reuse the same account. The SeaText integration guide says you must create separate accounts for each domain.

Step 2: Copy the JavaScript code from the account

After you create an account, find the JavaScript code inside that account. SeaText calls this the SEATEXT code integration. Each account gives you a code snippet. Use the snippet only on the domain linked to that account.

Step 3: Install the code in Shopify

Log in to Shopify and go to Online Store > Themes. Click the three dots next to your active theme and select Edit code. Open the Layout folder and select theme.liquid. Paste the JavaScript code into the <head> section or the area indicated in the integration guide. Then click Save.

Step 4: Repeat for each domain

Log in to the second SeaText AI account. Copy its code. Install that code in the second Shopify store. Do not use the first account's code.

Step 5: Add the product description tag if needed

If you use the product description optimization feature, open the product template in Shopify. Find the product description output code. Wrap it with the required data attribute as shown in the integration guide. Save and test on a product page.

For the exact integration steps, see the Shopify Integration guide.

How to Verify Domain-Account Matching in the Dashboard

After installation, confirm the primary URL matches the domain where the script is installed. Here is a simple check.

1. Log in to your SeaText AI account.
2. Open the dashboard or account settings.
3. Find the field labeled primary URL or domain.
4. Compare it with the domain in your browser address bar.
5. If they do not match, you have the wrong account installed.

You can also check the live site. Open your store in a browser. View the page source and look for the SeaText code. The code should be the same one that appears in the account set for that domain.

Finally, watch the account activity. If the dashboard shows no traffic for a store, the domain may be mismatched. If the dashboard shows traffic from the wrong store, the same problem exists.

Troubleshooting Mismatched Settings

Mismatched settings create clear symptoms. Use this guide to identify and fix them.

Problem: AI agents do not activate on the live site

Cause: The script from a development account was installed on the live domain. The primary URL does not match.

Fix: Remove that code. Create or activate the correct account for the live domain. Install the correct code.

Problem: No activity in the dashboard

Cause: The domain is a restricted development URL like localhost. SeaText restricts development URLs for security reasons. Dynamic development domains may not work because SeaText may be unable to reliably associate traffic with your account.

Fix: Use a real domain. For pre-production tests, use a staging subdomain such as staging.mystore.com. Create a separate account for that domain.

Problem: Product description changes do not appear

Cause: The data attribute is missing from the product template.

Fix: Open the product template file. Wrap the product description output with the required data attribute. Save the file and preview a product page. Use browser developer tools to inspect the HTML and confirm the attribute is present.

Problem: Two stores show the same account activity

Cause: The same JavaScript code was pasted into both Shopify stores.

Fix: Remove the code from one store. Create a new account for that store and install its unique code.

Development Domains vs. Staging Subdomains

SeaText treats development domains differently from real domains. localhost is not a real domain. It is restricted. Dynamic development domains from cloud IDEs may also fail. A staging subdomain like staging.mystore.com is a real domain. It can work if you create a separate account for it.

Use a staging subdomain when you need to test SeaText before launch. Give it its own account. Keep the live account separate. This prevents data contamination and avoids wasted time.

Managing Multiple Subscriptions and Billing

When you have multiple accounts, you also have multiple billing relationships. This can create confusion if you do not organize it.

Use a clear naming convention for each account. Include the store, domain, and purpose. For example, mystore-live and mystore-staging.

Keep a simple spreadsheet or note with:

• Domain
• Account email
• Primary URL
• Plan or subscription status

Use separate payment methods if you need to separate costs by client or project. If an invoice is unclear, check which account it belongs to before paying.

For pricing details, see the Shopify Integration page or the SeaText pricing section.

Common Questions About SeaText AI on Multiple Domains

Can I use one SeaText AI account on my main domain and a subdomain?

No. A subdomain is a separate domain. If you want SeaText on blog.mystore.com, that subdomain needs its own account.

Why is localhost blocked?

SeaText restricts development URLs for security reasons. A local URL is not a valid real domain, and dynamic development domains may not function properly.

How long does setup take for two stores?

According to SeaText, you can add Seatext to a site in under one minute. You also need to create an account and copy the code. The exact time depends on your theme and setup.

Can I change the primary URL later?

Based on the current instructions, each account is linked to a single primary URL. If you need a different domain, create a new account for it. Check with the vendor if you have an enterprise need.

What should I do if I already installed the same script on two domains?

Remove the script from one domain. Create a new account for that domain and install its unique script. Then verify the primary URL matches.

Further Reading and Comparison Sources

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

• Shopify Integration guide
• SeaText homepage
• Seatext AI on Capterra
• Seatext AI on GetApp

What the standard SeaText installation does

You should consider a custom API integration when you need real-time, bidirectional sync, high-frequency updates, or complex server-side logic that the standard JavaScript snippet cannot handle.

The default way to add SeaText to Odoo is a JavaScript snippet placed through the Website module's Embed Code block. According to SeaText's integration guide, you log into Odoo, open the Website editor, drag an Embed Code block into the page, paste the snippet, and save. That snippet loads SeaText's AI agents on the front end so they can rewrite copy, run A/B tests, translate content, and personalize the page for each visitor.

This approach is fast — under a minute — and requires no backend development. It also means SeaText only sees what the browser sees. It cannot read or write Odoo records such as products, orders, customers, or inventory unless those records are already rendered in the page HTML.

Readiness checklist: signs you need a custom API integration

• You need to push product data from Odoo to SeaText automatically. The JavaScript snippet cannot query Odoo's product catalog. If you want SeaText's Ecommerce Product Copy agent to optimize descriptions using live SKU, price, or stock data, you need a server-to-server connection.
• You need to send conversion events from Odoo back to SeaText. SeaText's Conversion Relay (CAPI) forwards purchases to Meta and Google, but it relies on front-end pixel data. If your checkout or order confirmation happens in a flow the snippet cannot see (for example, a headless checkout or a backend ERP order), you need an API call from Odoo to SeaText.
• You need real-time, bidirectional sync. The snippet is one-way: SeaText reads the DOM and rewrites it. It cannot update an Odoo record when a visitor interacts with an AI chat agent or when a personalization decision changes a product recommendation.
• You have high-frequency updates. If prices, stock levels, or promotions change many times per day and you need those changes reflected in SeaText-generated content immediately, polling the front end is too slow and fragile.
• You need to integrate with Odoo modules beyond Website. CRM leads, helpdesk tickets, inventory moves, accounting invoices — none of these are exposed to the Website front end. A custom integration using Odoo's XML-RPC, JSON-RPC, or REST endpoints can reach any model.
• You have complex business logic that must run server-side. Examples: dynamic pricing rules that depend on customer tier and warehouse location, or compliance checks before an AI-generated offer is shown. The snippet runs in the browser and cannot enforce server-side rules.

When to wait: the standard snippet is enough

• Your goal is on-page optimization only: headlines, product descriptions, CTAs, translations, A/B tests, personalization based on visitor behavior.
• All the data SeaText needs is already rendered in the page HTML (product name, price, description, images).
• You have a single domain. SeaText's standard account model ties one account to one primary URL; multiple domains need separate accounts regardless of integration method.
• You do not have developer resources to build, host, and maintain a middleware service that authenticates to Odoo's API and calls SeaText's endpoints.
• You are in a testing or pilot phase. The snippet can be added and removed in minutes without touching Odoo's database or server configuration.

How a custom API integration works

Odoo exposes three API families: XML-RPC (legacy, widely supported), JSON-RPC (used by the web client), and a native REST API introduced in Odoo 16 and expanded in 17+. The REST API is not yet comprehensive — core modules like HR, payroll, and accounting still have limited coverage — so most production integrations use XML-RPC or JSON-RPC via a middleware layer.

A typical custom integration runs on your own infrastructure (a small Node.js, Python, or Go service). It authenticates to Odoo using an API key or user credentials, subscribes to relevant model changes via webhooks or scheduled polls, transforms the data, and calls SeaText's backend APIs. SeaText's backend APIs are not publicly documented in SeaText's public documentation; you would coordinate with SeaText's team for endpoint specs, authentication, and rate limits.

The middleware also handles error retry, idempotency, and data mapping — for example, mapping Odoo's product.template fields to the schema SeaText's Ecommerce Product Copy agent expects.

Key facts

Limitations and exceptions

• SeaText's backend API is not public. You cannot build a custom integration without SeaText's cooperation. Contact their team for API access, documentation, and rate-limit policies.
• Odoo's REST API gaps. If your integration depends on accounting, payroll, or HR models, you may be forced to use XML-RPC or JSON-RPC, which are more complex to maintain.
• Authentication and hosting. A custom integration requires a secure, monitored server. If you do not have DevOps capacity, the operational burden may outweigh the benefit.
• Data privacy. Moving customer or order data between systems adds compliance surface (GDPR, CCPA). The snippet keeps data in the browser; a custom pipe moves it through your infrastructure.
• Single-domain pilot. If you are testing SeaText on one domain, the snippet lets you validate value before investing in custom engineering.

Practical scenarios

Scenario A: Ecommerce catalog optimization

You run a 10,000-SKU store on Odoo. Prices and stock update hourly from suppliers. You want SeaText's Ecommerce Product Copy agent to rewrite titles and descriptions daily using fresh data. The snippet cannot pull the catalog; a nightly API job from Odoo to SeaText can.

Scenario B: Closed-loop conversion tracking

Your checkout is a headless React app that talks to Odoo via API. The SeaText snippet never loads on the order-confirmation page. You add a server-side call from Odoo's sale.order write hook to SeaText's Conversion Relay endpoint so every purchase is attributed.

Scenario C: AI chat agent creates leads in Odoo CRM

SeaText's Free AI Website Chat agent qualifies visitors. When a visitor requests a demo, you want a crm.lead created in Odoo with the chat transcript. The snippet cannot write to Odoo; a webhook from SeaText to your middleware, then to Odoo's API, completes the loop.

Scenario D: Multi-language product feed

You use SeaText's Website Translation agent for 125 languages. You need the translated product descriptions stored back in Odoo so they appear in PDF catalogs, ERP exports, and marketplace feeds. A custom integration writes the translated fields to product.template via Odoo's API.

FAQ

Does SeaText offer a native Odoo module?

No. SeaText's integration guide shows only the JavaScript snippet method via the Website module's Embed Code block. There is no Odoo app in the Odoo App Store from SeaText.

Can I use Zapier or Make instead of custom code?

Only if SeaText exposes public API endpoints that those platforms can call. SeaText's public documentation does not document public APIs. Check with SeaText support; if they provide webhook URLs or REST endpoints, a no-code middleware may work for simple one-way flows.

What Odoo API should I use?

For broad model coverage, XML-RPC or JSON-RPC. REST is cleaner but incomplete for core modules as of Odoo 17+. Your middleware choice (Python, Node, Go) may favor one protocol.

How much does a custom integration cost?

SeaText's pricing is not public in SeaText's public documentation. Custom integration cost depends on your developer rates, scope (number of models, sync frequency, error handling), and ongoing maintenance. A minimal one-way sync might take 40–80 hours; a robust bidirectional system with monitoring can run 200+ hours.

Will a custom integration break when Odoo upgrades?

XML-RPC and JSON-RPC are stable across versions. REST endpoints may change. Pin your middleware to a specific Odoo version and test in a staging environment before each upgrade.

Can I run both the snippet and a custom API integration?

Yes. The snippet handles front-end AI agents (personalization, A/B testing, translation). The custom API handles backend data sync. They operate independently.

What if I only need to send UTM parameters to Odoo?

The snippet can read URL parameters and include them in form submissions or data-layer events. If your forms post to Odoo controllers, you may not need a custom API. Test the snippet first.

Terminology

• Embed Code block — Odoo Website builder component that allows raw HTML/JS injection.
• XML-RPC / JSON-RPC — Remote procedure call protocols Odoo uses for external access to its ORM.
• REST API — HTTP/JSON interface added in Odoo 16+, still incomplete for some core models.
• Middleware — A service you host that translates between Odoo's API and SeaText's API.
• Conversion Relay (CAPI) — SeaText feature that forwards purchase events to Meta and Google Conversions APIs.
• WebMCP — SeaText's protocol for turning a website into an MCP server for AI assistants like Claude and ChatGPT.

Understanding SeaText Data Attributes

SeaText uses HTML data-* attributes to mark elements that its AI agents should translate, optimize, or personalize. These attributes act as hooks: the SeaText script scans the DOM, finds elements with the expected attribute, and applies changes in real time. If the attribute is missing, misspelled, or holds an empty value, the agent skips that element silently.

The most common attribute you'll encounter is data-seatext (or a variant documented in your integration guide). In Shopify implementations, the integration instructions explicitly tell you to wrap product description output with this attribute and then verify it appears in the rendered HTML using browser developer tools.

Common Symptoms of Data Attribute Issues

• Translations or optimizations don't appear on specific pages or elements.
• Some languages work while others fall back to the original text.
• The SeaText dashboard shows "no elements found" or a low element count for a page you know should be processed.
• Changes flash briefly then revert, suggesting a script conflict or re-render.

These symptoms usually point to one of three root causes: the attribute isn't in the final HTML, the attribute name or value doesn't match what the script expects, or the SeaText script isn't executing on that page.

Diagnostic Sequence: Step-by-Step

1. Open DevTools and inspect the target element. Right-click the element (product description, heading, CTA) and choose Inspect. Look for data-seatext or the attribute name from your integration docs in the Elements panel.
2. Verify the attribute name and value. The name must match exactly (case-sensitive). The value should be a non-empty string — often a scope identifier like "product-description" or a locale code. An empty data-seatext="" will be ignored.
3. Check the Console for SeaText errors. Filter for "seatext" or look for network requests to seatext.com. A 401 or 403 on the script load means an account/domain mismatch. A JavaScript error in the SeaText bundle stops all processing.
4. Confirm the SeaText script loads on the page. In the Network tab, reload and find the SeaText JS file. It should return 200 OK. If it's missing, the snippet wasn't added to theme.liquid (Shopify) or the equivalent layout file on other platforms.
5. Review the SeaText dashboard logs. Log in to your SeaText account and open the domain's activity or error log. It records elements detected, API calls, and any server-side rejections.
6. Test with a minimal page. Create a static HTML file with only the SeaText snippet and a single <div data-seatext="test">Hello</div>. If it works there but not on your live page, the issue is in your theme or build pipeline.

Likely Causes and Their Fixes

Attribute stripped by theme or framework

Some Shopify themes or React/Vue build processes remove unknown attributes during rendering. In Shopify, the integration guide shows wrapping the product description output in product.liquid or product-template.liquid. If you placed the attribute in a snippet that gets compiled away, it won't reach the browser. Fix: add the attribute directly in the liquid file that outputs the final HTML, then verify with View Source (not just DevTools Elements panel, which shows the post-JS DOM).

Typo in attribute name

data-seatext vs data-sea-text vs data-seatext-scope — only the exact name documented for your integration works. Fix: copy the attribute name from the official documentation (documentation-ai-scope) and paste it into your template.

Script not loaded or loaded twice

The SeaText integration requires pasting a JavaScript snippet into theme.liquid (Shopify) or the global layout on other platforms. If you pasted it inside a conditional block that doesn't render on all pages, or if two snippets exist (old + new), the script either won't run or will conflict. Fix: ensure one snippet, placed just before </head> or </body>, on every page.

Domain/account mismatch

Each SeaText account is tied to a single primary URL. Development URLs like localhost or dynamic preview domains are restricted. If you're testing on a staging subdomain that isn't registered to your account, the script loads but the backend rejects requests. Fix: create a separate SeaText account for each domain (production, staging, development) as noted in the Shopify integration docs.

Content re-rendered after SeaText runs

Single-page apps or AJAX-loaded product details may replace the DOM after SeaText's initial scan. The attribute exists in the new HTML but SeaText has already finished. Fix: call the SeaText re-scan function (documented in the API) after your framework finishes rendering, or use the mutation observer mode if available.

Key Facts

Limitations and When This Advice Doesn't Apply

• This guide covers client-side data attribute debugging. Server-side rendering issues (e.g., Next.js getServerSideProps not passing attributes) need framework-specific fixes.
• If SeaText's backend changes its expected attribute schema, the documented name in your integration guide is the source of truth — not this article.
• Third-party scripts that sanitize DOM (some security tools, AMP validators) may strip data attributes after SeaText reads them. That's outside SeaText's control.
• Performance budgets: on pages with thousands of attributed elements, the initial scan may take measurable time. The diagnostic steps still apply, but the fix may be pagination or lazy attribution.

Terminology Quick Reference

Data attribute

An HTML attribute prefixed with data- (e.g., data-seatext) used to store custom data on elements. Valid per HTML spec.

DOM scan

The SeaText script's process of walking the document tree to find attributed elements.

Scope identifier

The value inside the data attribute that tells SeaText which agent or rule set applies (e.g., "product-description", "checkout-cta").

Inert script

SeaText's JS loads but does nothing until activated in your dashboard — a security feature.

Mutation observer

A browser API that watches for DOM changes; SeaText can use it to re-scan after AJAX updates.

FAQ

Why does SeaText work on my homepage but not product pages?

Product pages often use different templates (product.liquid vs index.liquid). The data attribute must be added to each template that outputs content you want processed. Check each template file separately.

Can I use the same SeaText account for my staging and production sites?

No. The source pack states each SeaText account is linked to a single primary URL. Create a separate account for each domain, including staging and development environments.

What does "AI remains inert until activated" mean for debugging?

The script loads and scans but makes zero changes until you enable agents in the SeaText dashboard. If you see the attribute and script load but no changes, confirm at least one agent (Translation, CRO, Personalization) is active for that domain.

How do I know if a third-party app is stripping my data attributes?

View the raw HTML source (curl or browser "View Source") rather than the DevTools Elements panel. If the attribute exists in source but not in Elements, a client-side script removed it. Disable apps one by one to isolate.

Does SeaText support dynamic attributes added via JavaScript?

Yes, if you trigger a re-scan. The script runs once on load. For SPAs, call the re-scan function after your router finishes rendering, or enable mutation observer mode if your plan includes it.

What's the fastest way to test if the attribute syntax is correct?

Create a minimal HTML file with the SeaText snippet and one attributed element. Open it directly in a browser. If it works there, your attribute syntax is fine — the problem is in your theme or build pipeline.

Where do I find the exact attribute name for my integration?

The official documentation at seatext.com/documentation-ai-scope lists the current attribute names and values for each platform and agent type.

SeaText AI needs two essential data attributes to operate: data-seatext-product-id on every product page so the system can identify and optimize product content, and data-seatext-user-id on all pages to enable real-time personalization for each visitor. Without these attributes, the AI cannot locate the elements it should rewrite, test, or translate. The attributes are added directly in your theme templates or product markup; the JavaScript snippet you paste into theme.liquid then reads them to decide what to optimize.

Why Data Attributes Matter

Data attributes act as anchors that tell SeaText which parts of a page are eligible for AI-driven changes. The script scans the DOM for these markers, then applies the active agents — copy optimization, translation, A/B testing, personalization — only to the tagged sections. If an attribute is missing, the corresponding agent simply skips that element. This design keeps the AI inert on pages where you haven't explicitly opted in, preserving your existing layout and content until you're ready.

Core Required Attributes

data-seatext-product-id

Place this attribute on the container that wraps each product's name, description, price, and call-to-action. In a typical Shopify theme, that container lives in product.liquid or product-template.liquid. The value should be the unique product identifier from your catalog (e.g., the Shopify product handle or numeric ID). Example: <div data-seatext-product-id="{{ product.id }}">...</div>. This attribute enables the Ecommerce Product Copy agent, AI Copy A/B Testing, and AI Personalization Agent to rewrite and test product-specific content.

data-seatext-user-id

Add this attribute to a high-level wrapper that exists on every page — often the <body> tag or a persistent header element. The value is a stable, anonymized visitor identifier (cookie-based or session-based) that lets the AI Personalization Agent adapt copy in real time. Example: <body data-seatext-user-id="{{ customer.id | default: 'anon_' | append: cart.token }}">. Without it, personalization falls back to generic variants.

Additional Attributes for Specific Features

These optional attributes are only needed when you activate the corresponding agent in the SeaText dashboard. The core script ignores unknown attributes, so you can add them incrementally.

Readiness Checklist Before You Install

• Account created: You have a SeaText AI account tied to your primary domain (each domain needs its own account).
• Theme access: You can edit theme.liquid and product template files in Shopify (Online Store → Themes → Actions → Edit code).
• Product ID scheme decided: Choose whether to use Shopify numeric IDs, handles, or SKUs — stay consistent across the catalog.
• User ID strategy defined: Determine how you'll generate anonymous IDs for non-logged-in visitors (cookie, session storage, or cart token).
• Development domain handled: Localhost and dynamic preview URLs are restricted; use a real staging domain with its own SeaText account.
• Backup taken: Duplicate your live theme before editing so you can revert instantly.
• Agent selection known: Decide which agents you'll activate (Product Copy, Translation, A/B Testing, Personalization, etc.) so you only add the attributes you need.

Step-by-Step Implementation (Shopify Example)

1. Log in to Shopify admin → Online Store → Themes → Actions → Edit code on your active theme.
2. Open layout/theme.liquid. Paste the SeaText JavaScript snippet just before the closing </head> tag. Save.
3. Open the product template (product.liquid or sections/product-template.liquid). Locate the outer wrapper of the product details.
4. Add data-seatext-product-id="{{ product.id }}" to that wrapper. Save.
5. In theme.liquid, add data-seatext-user-id="{{ customer.id | default: 'anon_' | append: cart.token }}" to the <body> tag. Save.
6. (Optional) Add feature-specific attributes from the table above to the relevant sections.
7. Preview a product page. Open browser dev tools → Elements → search for data-seatext- to verify attributes render correctly.
8. In the SeaText dashboard, activate the agents you need. The AI will start reading the attributes on the next page view.

Common Mistakes and Troubleshooting

• Attribute on wrong element: Placing data-seatext-product-id on a single <span> instead of the full product card prevents the agent from rewriting the description, price, or CTA together.
• Duplicate IDs: Using the same product ID on multiple products (e.g., a collection page loop without unique keys) confuses the optimizer.
• Missing user ID on checkout: If the attribute disappears on the order confirmation page, Conversion Relay cannot capture the purchase event.
• Staging domain not registered: SeaText blocks localhost and dynamic preview URLs. Create a separate account for each real staging domain.
• Script loaded after DOM: The snippet must be in <head>; placing it at the bottom of <body> delays attribute detection.

Limitations and When Attributes Are Not Needed

• Pages without any SeaText agents activated (e.g., blog posts, privacy policy) do not require attributes.
• If you only use the Free AI Website Chat agent, no data attributes are required — the chat widget injects its own container.
• Translation-only deployments can rely on automatic language detection without data-seatext-translate, but the attribute gives you granular control over which blocks are translated.
• Multi-domain setups need separate SeaText accounts; attributes from one account do not work on another domain.

Key Facts

Frequently Asked Questions

Do I need coding skills to add these attributes?

Basic Liquid/HTML editing is enough. The changes are two to three lines in theme.liquid and one line in your product template. If you're uncomfortable editing theme code, a developer can do it in under 15 minutes.

Can I use SeaText on a headless Shopify storefront?

Yes. Add the same attributes to your React/Vue/Next.js product components and include the SeaText script in your <head>. The attribute names and values stay identical.

What happens if I forget data-seatext-user-id?

Personalization agents fall back to generic variants. Copy optimization and translation still work on product pages that have data-seatext-product-id.

Can I test attributes on a password-protected staging site?

Only if the staging site uses a real domain (e.g., staging.mystore.com) with its own SeaText account. Password protection does not block the script, but localhost and Shopify preview links do.

Do attributes affect page speed?

No. They are static HTML attributes. The SeaText script loads asynchronously (≈15 KB gzipped) and reads attributes after DOM ready.

How do I verify attributes are working?

Open a product page, right-click → Inspect, search for data-seatext-. You should see both core attributes. In the SeaText dashboard, the "Installation Status" panel shows detected attributes per page type.

Can I add attributes via Google Tag Manager instead of theme code?

Not recommended. GTM injects after DOM ready, so the SeaText script may miss the attributes on first render. Hard-code them in the theme for reliable detection.

Testing SeaText data attributes takes about five minutes. Open the page where you added the attributes, launch your browser's developer tools, and confirm two things: the attribute appears in the HTML source, and the SeaText script picks it up without errors. Use a real product or landing page, not a localhost URL, since development domains are restricted.

What you need before testing

Have these items ready before you start:

• A live web page on a real domain where SeaText is installed.
• The SeaText account where you generated the integration code.
• Access to the browser developer tools (right-click and choose Inspect, or press F12).
• A clear idea of which data attributes you planned to add (for example, a product description tag inside a Shopify theme).

Make sure the JavaScript snippet SeaText gave you is still in your theme or layout file. The AI stays inert until you activate it in the dashboard, so a missing snippet will look like the attributes are broken when the script itself is the problem.

Step-by-step: verify data attributes with SeaText

1. Open the live page. Load the product or landing page in a normal browser tab, not an editor preview.
2. Open developer tools. Press F12 or right-click the area you tagged and choose Inspect.
3. Find the wrapped element. Use the Elements tab and search (Ctrl+F) for the data- prefix you used, such as data-seatext-product-description.
4. Confirm the syntax. The attribute name should use lowercase letters, hyphens, and the exact name from SeaText's setup guide. Spelling or casing mistakes will silently break the connection.
5. Check the Network tab. Reload the page and look for requests to SeaText's domain. A request that contains your attribute value as a parameter means the script read it.
6. Watch the Console tab. Look for SeaText-related log messages or errors. A clean run with no errors is a good sign, but it does not prove the attribute was read; the Network check is stronger proof.
7. Check the SeaText dashboard. Open the matching page view or analytics screen in your SeaText account to see whether the tagged content shows up.

Alternative tests that catch more edge cases

The basic check works for most setups. A few extra tests help when something looks off:

• Run in a private window. Cache and extensions can hide script errors. A private window shows what a first-time visitor sees.
• Use a second browser. Chrome, Firefox, and Safari can render scripts differently. A quick cross-browser check confirms the attribute survives.
• Read the page source. Press Ctrl+U and search for the attribute. If it is missing there, the theme is stripping your tag before the browser sees it.
• Disable other scripts. Turn off chat widgets or analytics tools one at a time. Conflicts can stop SeaText from initializing.

Common reasons a data attribute fails to register

Most failures come from small setup mistakes. Check these first:

• Wrong file. The tag landed in the wrong template, so the attribute never appears on the page you are testing.
• Theme overrides. Some themes rewrite HTML on render and can drop unknown attributes. Inspect the live element, not the source file.
• Localhost testing. SeaText restricts development URLs for security, so attributes may not fire on localhost or staging subdomains.
• Multiple accounts. Each SeaText account is tied to one primary domain, so a script from a different account will not recognize your tags.
• Not saving the theme. After pasting the wrap, you have to click Save in the theme editor or the change never ships.

How SeaText reads attributes under the hood

SeaText installs a small JavaScript snippet on every page. That script looks for the data attributes you added, reads their values, and passes the content to the AI agents for translation, testing, or personalization. When the attribute is missing, misspelled, or wrapped around the wrong element, the script has nothing to send, so nothing changes on the page. The dashboard will show the field as empty, and your tests will look like nothing happened.

This design is why a quick DOM inspection is the most reliable test. If the attribute is in the HTML and the script ran without errors, the value reaches SeaText.

Verification checklist

Limitations to keep in mind

A passing test on one page does not guarantee every page works. Templates can differ, especially in ecommerce stores where collection, product, and cart templates render separately. Test at least one page per template that uses the attribute.

Also remember that development and staging domains are not supported. If your team works on a staging URL, plan to run the full check on production or a clone of the production domain before launch.

Frequently asked questions

Do data attributes work on staging or localhost URLs?

No. SeaText restricts development URLs for security, and dynamic development domains may not be associated with your account. Test on a real domain.

How long does it take for a change to appear in the dashboard?

Most updates show up within a few minutes after a visitor loads the page. If you do not see traffic, refresh the dashboard or open the page yourself in a new tab.

Can I test data attributes without activating an AI agent?

Yes. The integration script runs even when no agent is active. You can verify the attribute is read without turning on translation or A/B testing.

What is the difference between a data attribute and a CSS class for this purpose?

CSS classes control style. Data attributes carry custom data that scripts can read without affecting layout. SeaText uses data attributes because the script needs the value, not a visual change.

Will a theme update remove my data attributes?

Yes, if the attribute lives in a template file that the theme overwrites during an update. Keep a backup of your edits and reapply them after major theme updates.

Can I test multiple attributes on the same element?

Yes. HTML allows any number of data attributes on one element. SeaText will read each one you added in the wrap.

What should I do if the Network tab shows no request to SeaText?

Open the Console tab and look for a script load error. The most common cause is the snippet being placed inside a conditional comment or removed by a security plugin.

Next step

Once your data attributes show up in both the HTML and the Network tab, you are ready to activate the SeaText agents that use them. Start with one agent on a single page, watch the dashboard, and scale from there.

Why SeaText-Odoo Setup Errors Matter

SeaText adds AI agents to your Odoo website. It can change page copy, translate content, and support ad campaigns. Those tools only work after the script is installed correctly. One small setup error can keep the AI inactive.

Most setup errors happen during the first install. The Odoo Website Builder has a specific place for custom code. The SeaText account has a specific code snippet for each domain. If those pieces do not match, the script cannot run.

Setup errors also waste time. You may think the tool is broken when the real problem is a copied code string or a hidden block. Knowing the symptoms first makes the fix faster.

This guide walks through each common mistake. You will see what goes wrong, how to check it, and how to prevent it on the next site.

How the SeaText-Odoo Integration Works

The official SeaText Odoo integration uses Odoo's Website Builder. You add an Embed Code module to a page and paste a JavaScript snippet into it. The process has a few simple steps.

1. Log in to your Odoo account.
2. Open the Website module from the dashboard.
3. Go to the page you want to edit.
4. Click Edit to open the editing panel.
5. Scroll to the Dynamic Content section in the Blocks panel.
6. Drag the Embed Code module into the page.
7. Click Edit on the module.
8. Paste the SeaText JavaScript snippet into the pop-up window.
9. Click Save.
10. Open the Visibility section and select Hide on Desktop.
11. Click Save again.

You copy the JavaScript snippet from the SEATEXTCODEINTEGRATION section in your SeaText account. That snippet is unique to your account and primary domain.

The integration is secure. The AI remains inert until it is activated. This means a mistake usually prevents activation instead of damaging your website.

Most Common Mistakes and How to Fix Them

Mistake 1: Using the wrong API key or code snippet

SeaText gives you a JavaScript snippet that belongs to one account. If you paste a snippet from another account, the AI cannot activate. The same problem happens if the snippet is edited or truncated.

Consequence: The script may appear on the page, but SeaText does not recognize it. Your dashboard shows no activity.

Troubleshooting: Copy the snippet again from the SEATEXTCODEINTEGRATION section. Paste it into the Embed Code module. Compare the first few characters with the one in your account. They should match exactly.

Prevention: Copy the snippet only from the account for the domain you are using. Do not type or rewrite the code by hand.

Mistake 2: Using a localhost or development domain

SeaText restricts development URLs such as localhost for security reasons. Dynamic development domains may also fail. The system cannot reliably associate traffic with your account on those URLs.

Consequence: The code is present, but no data flows. Testing on localhost gives you false confidence.

Troubleshooting: Open the site on your real domain. Log in to SeaText and check the registered primary URL. If the URL is localhost, switch to a valid domain.

Prevention: Use a real domain from day one. If you need a separate test environment, create a separate SeaText account for that domain.

Mistake 3: Forgetting to hide the embed block

When you drag the Embed Code module into an Odoo page, Odoo may show it as a block on the page. The official instructions tell you to select Hide on Desktop in the Visibility section.

Consequence: Visitors on desktop may see an empty or broken block. The layout can collapse. The AI may still run, but the page looks wrong.

Troubleshooting: Edit the page. Open the Embed Code module. Go to Visibility and select Hide on Desktop. Save the page.

Prevention: Add Hide on Desktop to your setup checklist. Do it immediately after pasting the code.

Mistake 4: Using one account for several domains

Each SeaText account is linked to a single primary URL. If you paste the same code on two domains, only the primary domain will work.

Consequence: The second site shows no AI behavior. You may see errors in the console or no data in the dashboard.

Troubleshooting: Confirm the domain registered to your SeaText account. For each domain, use a separate account with its own snippet.

Prevention: Before install, list every domain you plan to use. Create one SeaText account for each domain.

Mistake 5: Not updating the Odoo app list

Odoo does not always show a newly installed module immediately. After you add the Embed Code module, the Apps menu may still show an old list.

Consequence: You cannot find the SeaText module to check its status. You may reinstall the module by mistake.

Troubleshooting: Go to the Apps menu. Click Update Apps List. After the refresh, look for the SeaText module.

Prevention: Refresh the app list right after installation. This takes a few seconds and prevents confusion.

Mistake 6: Giving users the wrong access rights

Website editors need permission to see and edit the Embed Code module. Without the right Odoo role, the block may not appear in the editor.

Consequence: An editor cannot paste the SeaText snippet or save changes. The setup fails silently.

Troubleshooting: Go to Settings > Users & Companies > Users. Open the user profile. Add Website Editor or Administrator access rights.

Prevention: Review user permissions before starting the integration. Make sure the person pasting the code has edit rights.

Key Facts About the SeaText-Odoo Integration

Trade-offs and Practical Considerations

One account per domain is the biggest trade-off. It keeps traffic data clean, but it means more logins and more snippets. Plan your domain list before you start.

Staging sites need their own account. If you test on a staging domain, your main account will not see that traffic. You can still use the staging account to verify the script loads.

The official steps assume you use the Odoo Website Builder. If you use a custom theme, the Dynamic Content section may be in a different place. Check your theme documentation for the correct block location.

The Hide on Desktop step only makes sense for a block on a page. If you add the script directly to the theme header, there is no block to hide. That method is not covered by SeaText's official Odoo steps.

Do not use dynamic development domains. They may produce traffic that SeaText cannot associate with your account. Use a fixed, real domain even for tests.

If you run many Odoo websites, create a setup log. Write down which account and snippet belongs to which domain. This prevents cross-domain mistakes later.

Prevention Checklist

• Use a valid real domain, not localhost.
• Copy the snippet from the correct SeaText account.
• Create a separate SeaText account for every domain.
• Review user permissions before editing the page.
• Refresh the Odoo app list after installation.
• Set the Embed Code block to Hide on Desktop.
• Save the page after every change.
• Open the site in a private window to confirm the script loads.

Review your SeaText account settings and Odoo user permissions before activating. The setup will go faster when the correct domain, snippet, and editor rights are in place.

Frequently Asked Questions

Why does SeaText not activate after I paste the code?

The most common cause is a mismatch between the code snippet and the domain. Check the primary URL in your SeaText account and confirm you used the snippet from that account.

Can I test SeaText on localhost?

No. Localhost is restricted. Use a valid, real domain. If you need a test environment, create a separate SeaText account for the test domain.

Do I have to refresh the Odoo app list?

Yes, after the first install. The Apps menu can show stale data. Use Update Apps List to make the SeaText module visible.

What if the embed block appears on the page?

Open the page editor, select the Embed Code module, and choose Hide on Desktop in the Visibility section. Save the page.

Can I use the same SeaText code on two websites?

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

Further Reading and Comparison Sources

These external sources provide additional context about Odoo implementation mistakes. Their inclusion is not an endorsement.

• Common Odoo Implementation Mistakes and How to Avoid Them?
• Common Odoo Implementation Pitfalls to Avoid
• Top Odoo Implementation Mistakes to Avoid for Successful Integration

After installing SeaText AI on your website, the script may fail to connect and activate. The most common reasons are straightforward: an incorrect API key, using a localhost or development domain, a firewall blocking the script, an outdated or misplaced code snippet, or missing Shopify permissions. Below we diagnose each cause in order of likelihood and provide step-by-step fixes with detailed explanations.

Symptoms of a Failed Connection

Before troubleshooting, confirm you have a connection problem. Typical signs include:

• The SeaText AI dashboard shows no activity or “inactive” status.
• Your website’s page source does not contain the SeaText JavaScript snippet.
• AI agents (e.g., CRO Optimizer, Translation) do not appear in your account.
• Browser console errors such as “Failed to load resource” or “net::ERR_BLOCKED_BY_CLIENT”.
• No network request to the SeaText CDN appears in the Network tab.

If you see any of these signs, proceed to the diagnosis order below.

Diagnosis Order: Where to Check First

Start with the simplest checks, then move to more technical ones. Use this order:

1. Verify your SeaText AI account – Ensure you have an active account and the correct API key. Log in at seatext.com and confirm the account status.
2. Check the domain – Confirm the domain in your account matches the live website URL exactly. According to official documentation, each account is linked to a single primary URL.
3. Inspect the code snippet – Open your theme’s HTML and look for the SeaText script. Verify it matches the current version from your account.
4. Test with browser tools – Use the Console and Network tabs to see if the script loads. Filter by “seatext” in the Network tab.
5. Disable plugins temporarily – Turn off security or ad-blocker plugins to see if they are blocking the script.

Common Cause #1: Incorrect or Missing API Key

The most frequent issue. Each SeaText AI account has a unique API key that must be copied exactly into the installation script. If you copy the key from an older account or miss a character, the connection fails.

Why this happens: The API key ties the script to your specific account. A typo, extra space, or using a key from a different account breaks authentication.

Fix: Log in to your SeaText AI account, go to the integration section, copy the JavaScript code again, and paste it into your website template. Ensure no extra spaces or line breaks are added. Compare the snippet in your page source with the one in your account character by character.

Troubleshooting tip: If you recently reset your API key, update the snippet on every page where it appears.

Common Cause #2: Wrong Domain or Using Localhost

SeaText AI links each account to a single primary URL. If you installed the script on a development domain (e.g., localhost, staging.example.com) or a different domain than registered, the AI will not connect.

Why this happens: Official documentation states that development URLs like localhost are restricted for security reasons. Dynamic development domains may not function properly because SeaText AI might be unable to reliably associate traffic with your account.

Fix: Use a real, live domain (e.g., www.yourstore.com). If you need multiple domains, create separate accounts for each. Each SeaText AI account is linked to one primary URL.

Example: If your account is registered for “example.com” but you install on “shop.example.com”, the connection will fail. Register the exact subdomain or use the root domain.

Common Cause #3: Firewall or Security Plugin Blocking the Script

Your website’s firewall (e.g., Cloudflare, Wordfence) or a browser extension may block the SeaText script. This is especially common with ad-blockers or strict content security policies.

Why this happens: Security tools often block third-party scripts by default. The SeaText script loads from a CDN, which can trigger blocking rules.

Fix: Temporarily disable security plugins or whitelist the SeaText domain. Check your Content Security Policy headers to ensure they allow scripts from the SeaText CDN.

Trade-off: Whitelisting a domain reduces your security posture slightly. Only whitelist the specific SeaText CDN domain rather than using broad directives like “script-src *”. If you use a strict CSP, add the exact CDN hostname to your script-src directive.

Advanced check: In the browser Network tab, look for a request to the SeaText CDN with a status of “blocked” or “canceled”. The Console may show “Refused to load the script because it violates the Content Security Policy directive”.

Common Cause #4: Outdated or Incorrectly Placed Code Snippet

SeaText AI updates its code periodically. If you installed an old version or placed the snippet in the wrong location (e.g., inside a conditional tag), the script may not execute.

Why this happens: Older snippets may reference deprecated endpoints. Placement inside conditional logic (e.g., only on product pages) prevents the script from loading on other pages where agents need to run.

Fix: Re-copy the snippet from your account and place it in the <head> section of your theme’s theme.liquid file (for Shopify) or before the closing </body> tag. Test by viewing the page source on multiple page types (home, product, collection).

Shopify-specific steps (from official docs): Access your Shopify admin, navigate to Online Store > Themes, click Actions > Edit code for your active theme, locate the Layout folder, open theme.liquid, paste the snippet in the <head> section, and click Save.

Common Cause #5: Missing Shopify Permissions

If you use Shopify, you need to edit theme code to add the SeaText snippet. Without proper permissions (e.g., “Edit code” access), the script cannot be inserted.

Why this happens: Shopify staff accounts may lack the “Themes” permission. Collaborator accounts may have restricted access.

Fix: Ensure you have the correct Shopify user role that allows editing theme files. Navigate to Online Store > Themes > Actions > Edit code, then locate theme.liquid and paste the snippet. If you cannot see “Edit code”, request the “Themes” permission from the store owner.

Verification: After saving, visit the live site and view page source. Search for “seatext” to confirm the snippet appears in the <head>.

Trade-offs and Security Considerations

When fixing connection issues, you may encounter trade-offs that affect security or workflow:

• Whitelisting domains: Adding the SeaText CDN to your Content Security Policy or firewall allowlist reduces the strictness of your security policy. Mitigate this by allowing only the specific CDN hostname, not wildcards.
• Separate accounts for multiple domains: Official documentation requires one account per domain. This means separate billing, separate agent configurations, and no cross-domain analytics. Plan for this if you manage multiple stores.
• Development vs. production: You cannot use localhost or dynamic staging domains. You must use a real domain even for testing. This may require a staging subdomain (e.g., staging.yourstore.com) with its own SeaText account.
• Script placement in vs. : Placing in ensures early loading but may slightly increase page load time. The official docs recommend for Shopify. For non-Shopify sites, before is acceptable but may delay agent activation.

Limitations and When This Advice Doesn’t Apply

These fixes assume you are using a standard website or Shopify store. If you are using a custom CMS, static site generator, or a PWA without a traditional server, the integration steps may differ. For advanced setups, refer to the SeaText documentation or contact support. Also, if you are using a proxy or load balancer, additional configuration may be needed to allow the script to load.

Server downtime or CDN issues are not mentioned in the official Shopify integration documentation. If you suspect this, check the SeaText status page or community forums, but treat it as a rare possibility not covered by official docs.

Frequently Asked Questions

What does “net::ERR_BLOCKED_BY_CLIENT” mean in the console?

This error typically means a browser extension (ad blocker, privacy tool) blocked the SeaText script. Disable extensions one by one to identify the culprit, then whitelist the SeaText CDN in that extension.

Why does the Network tab show a 403 status for the SeaText script?

A 403 usually indicates the API key is invalid or the domain does not match the registered primary URL. Verify both in your SeaText account.

Can I use a single SeaText account for a main domain and its subdomains?

No. Official documentation states each account is linked to a single primary URL. Subdomains count as separate domains and require separate accounts.

How do I verify the script is loading on all page types in Shopify?

Visit the home page, a product page, a collection page, and the cart page. On each, open developer tools, go to the Network tab, filter by “seatext”, and confirm a 200 response.

What if my CSP uses a nonce or hash for inline scripts?

The SeaText snippet is an external script, not inline. Ensure your CSP’s script-src includes the SeaText CDN hostname. Nonces and hashes apply to inline scripts, so they do not affect the SeaText snippet.

I have a headless Shopify setup (Hydrogen/Remix). Where do I place the snippet?

Headless setups require adding the script to your frontend framework’s root layout or _document file. The official Shopify integration guide covers only Online Store themes. Consult SeaText support for headless-specific guidance.

SeaText AI relies on specific data- attributes to locate, translate, test, and personalize content on your site. When those attributes are missing, misspelled, or attached to the wrong elements, the AI agents simply skip the content — no error message, no warning, just silent failure. The good news: every common mistake has a straightforward fix once you know what to look for.

Why data attributes matter for SeaText

SeaText's autonomous agents — translation, CRO, personalization, A/B testing, and more — read your live HTML. They do not crawl a separate feed or API. The data- attributes you place on elements act as explicit signals: "optimize this text," "translate this block," "exclude this section." Without correct attributes, the agents treat the content as opaque and leave it untouched.

This design keeps integration lightweight — one JavaScript snippet — but shifts responsibility to the markup. A single typo in an attribute name can disable optimization for an entire product catalog or landing page.

Mistake 1: Using the wrong attribute name

SeaText expects specific attribute keys such as data-seatext, data-seatext-scope, or data-seatext-exclude. Developers often guess names like data-ai, data-translate, or data-cro. Those are ignored.

Check the current documentation for the exact attribute names required by each agent. The attribute names are case-sensitive and must match exactly.

Mistake 2: Missing required attributes on dynamic content

Single-page applications, AJAX-loaded product grids, and infinite-scroll feeds often render HTML after SeaText's initial page scan. If the new elements lack the required data- attributes, the agents never see them.

Solution: re-initialize or notify SeaText after DOM mutations. The integration snippet exposes a method to rescan the page; call it whenever new content is injected.

Mistake 3: Placing attributes on wrapper elements instead of text nodes

Wrapping a whole <div> with data-seatext works only if the agent's scope logic matches that structure. For granular control — translating a headline but not a price, testing a CTA but not a disclaimer — attach attributes to the smallest element that contains the target text.

Example: put data-seatext on the <h1>, not the parent <section>.

Mistake 4: Not updating attribute values when content changes

Some SeaText attributes accept values (e.g., data-seatext-scope="product-description"). If your CMS swaps the content but leaves a stale scope value, the agent may apply the wrong optimization rules or skip the block entirely.

Treat attribute values as part of your content model: update them whenever the semantic meaning of the element changes.

Mistake 5: Conflicting or duplicate attributes

Adding both data-seatext and data-seatext-exclude on the same element creates ambiguity. The agent's resolution order is documented, but relying on it is fragile. Choose one intent per element.

Similarly, nested elements with contradictory scopes (parent says "translate all," child says "exclude") can produce unexpected results. Keep the attribute tree flat and intentional.

Mistake 6: Ignoring Shopify theme structure requirements

On Shopify, SeaText's integration guide instructs you to edit theme.liquid and wrap product description output in the required attributes. A common error is pasting the snippet into the wrong file — for example, product.liquid instead of the layout file — or forgetting to save after editing.

The guide specifies: locate theme.liquid under the Layout folder, paste the JavaScript snippet, then save. Skipping the save step leaves the site without the SeaText runtime entirely.

Mistake 7: Using development domains that SeaText blocks

SeaText restricts localhost and dynamic development domains for security. If you test on dev.example.com or a tunnel URL, the script may fail to associate traffic with your account, and attributes will appear inert.

Use a real, registered domain for each environment. Create a separate SeaText account per domain as required by the platform.

Scope and definitions

Data attribute: an HTML attribute prefixed with data- that stores custom data on standard elements. SeaText defines its own set of attribute names and expected values to control AI agent behavior.

Agent: an autonomous SeaText module (translation, CRO, personalization, etc.) that reads the live DOM and mutates text in real time.

Scope: a value on a data-seatext-scope attribute that tells an agent which optimization rules to apply (e.g., "product-description", "headline", "cta").

Key facts from SeaText documentation

Diagnostic checklist when attributes seem ignored

1. Open browser dev tools → Elements tab. Search for data-seatext. Absent? The markup never received it.
2. Check console for SeaText initialization logs. Errors there point to script load or domain mismatch.
3. Verify the SeaText snippet is present in <head> or before closing <body>.
4. Confirm the page URL matches the primary domain in your SeaText account settings.
5. If content loads via AJAX, call the rescan method after injection.
6. Review the attribute name spelling against current docs — names change across versions.

Limitations and when this advice does not apply

• This article covers SeaText's client-side attribute model only. Server-side rendering integrations or API-based workflows may use different mechanisms.
• Attribute names and behaviors can change between SeaText releases. Always consult the live documentation at the URL referenced in the integration guide.
• Third-party frameworks (React, Vue, Svelte) may require framework-specific binding patterns to keep attributes in sync with state.
• Shopify headless implementations using Hydrogen or custom storefronts follow different integration steps than the Online Store theme editor flow described in the source pack.

Practical scenarios

Scenario: Product descriptions not translating

Merchant adds SeaText snippet to theme.liquid but product pages stay in English. Inspection shows the product description <div> lacks data-seatext. Fix: edit the product template (product.liquid or product-template.liquid), wrap the description output variable with the attribute, save, and verify in dev tools.

Scenario: A/B test not running on CTA buttons

Marketing team expects SeaText to test button copy. Buttons have data-seatext on the parent <a> tag, yet no variants appear. The agent scopes to text nodes; the attribute must sit on the element containing the button text (often a <span> inside the <a>). Move the attribute inward.

Scenario: Personalization works on homepage but not on AJAX category pages

Infinite-scroll category pages load products via fetch. New product cards arrive without data-seatext-scope. Fix: after each fetch completes, call window.seatext.rescan() (or the current API equivalent) so agents process the new nodes.

FAQ

What is the exact attribute name SeaText expects for translation?

The current documentation at https://seatext.com/documentation-ai-scope lists the authoritative attribute names. As of the integration guide, data-seatext and data-seatext-scope are used. Verify before implementing.

Do I need to add attributes to every single text element?

No. Add attributes only where you want agent control. Unmarked content is left alone. For site-wide translation, the translation agent can operate without per-element attributes, but granular control requires them.

Can I use data attributes with React or Vue components?

Yes. Render the attributes in your component JSX or template. Ensure they persist through re-renders. If the framework strips unknown attributes, configure it to allow data-* passthrough.

Why does SeaText work on my staging domain but not production?

Each SeaText account is tied to one primary URL. If staging and production are different domains, you need two accounts. Also confirm production uses a real domain — not a dynamic tunnel — and that the snippet is deployed in the production build.

How do I exclude a section from all agents?

Add data-seatext-exclude (or the current exclude attribute name from docs) to the container element. Do not combine with data-seatext on the same element.

What happens if I misspell an attribute name?

SeaText ignores unknown attributes silently. No console error, no fallback. The element behaves as if no attribute was present.

Is there a way to validate attributes before deploying?

Use the browser dev tools console on a staging page. After SeaText loads, run the diagnostic method exposed by the snippet (documented in the integration guide) to list detected scopes and elements.

This guide is a readiness checklist for connecting SeaText AI to Shopify. It lists every requirement and explains why it matters. If you meet the items below, the setup should run smoothly.

What You Need Before You Start

Check these requirements before you install anything. A missing item can block the installation or cause tracking problems later.

• Shopify plan that supports apps and code editing. SeaText AI adds a JavaScript snippet to your theme. Your plan must allow app-style scripts and theme file edits. Check with Shopify for current plan limits.
• Active SeaText AI account. You need an account to get the JavaScript code. Create one at seatext.com if you do not have it.
• Stable internet connection. You will log in to Shopify admin and edit theme files. A stable connection avoids lost changes.
• Modern browser. Use a current browser such as Chrome, Firefox, Edge, or Safari. This makes copy, paste, and testing easier.
• Theme editing access. You need permission to open your theme files and edit code. Store owners and developers usually have this access.
• One SeaText account per domain. Each domain needs its own account. Localhost and dynamic development domains are restricted.

You do not need additional hardware or a separate server. The only required pieces are a compatible Shopify store, a SeaText account, and access to your theme files.

Log in to Shopify and open Online Store > Themes. Look for the Edit code button. If it is missing, your plan or theme may not support code edits.

How the SeaText AI Shopify Integration Works

SeaText AI connects to Shopify through your theme code. You place a JavaScript snippet in your theme. The snippet works as a bridge between your store and SeaText agents.

The AI stays inactive until you activate it. This protects your website content. It also means the connection alone will not change your product pages. You decide which agents to turn on after the installation.

After activation, the agents can make real-time changes on the storefront. For example, an ecommerce agent can optimize product descriptions. A translation agent can rewrite pages in another language. You control which agents run.

Why does this matter? Because the integration is code-based. A plan without code access cannot run the snippet. A domain that changes cannot be linked reliably to your account. Each requirement exists to make the connection stable and secure.

Step-by-Step Installation on Shopify

The installation has two main parts. First, add the JavaScript snippet to your layout file. Second, add a data attribute to the product template. Follow the instructions inside your SeaText account for the exact code.

1. Log in to Shopify. Go to Online Store > Themes.
2. Open the theme code. Click the three dots beside your theme, then choose Edit code.
3. Find theme.liquid. In the Layout folder on the left side, open theme.liquid.
4. Copy the SeaText code. Copy the JavaScript code from the SEATEXT AI section in your account.
5. Paste the code. Paste it into theme.liquid where the account instructions show.
6. Save the layout. Click Save to keep your changes.
7. Find the product template. Locate product.liquid or product-template.liquid.
8. Wrap the product description. Add the data attribute around the output code. Use the pattern shown in your SeaText account.
9. Save the template. Save the file after adding the attribute.
10. Test the page. Preview a product page. Open browser developer tools and inspect the HTML source. Confirm the data attribute is present.
11. Activate agents. In SeaText, activate the agents you need for your store.

If the data attribute does not appear, check that you edited the correct file. Product templates can have different names depending on your theme.

Do not paste the code into multiple layout files. One copy in theme.liquid is normally enough. Save the layout file before you move to the product template.

Multiple Domains and Account Rules

Each SeaText account is linked to a single primary URL. This is why you cannot use one account for multiple stores. If you have two websites, create two accounts.

Development domains have special rules. Localhost is restricted for security reasons. Dynamic development domains may not work because SeaText cannot reliably associate traffic with your account.

Use a real domain for development. A subdomain such as dev.yourstore.com is a valid option. Create a separate SeaText account for that subdomain if you want to test there.

Practical scenario: You have a staging store and a live store. Install SeaText on each domain with its own account. This keeps settings and traffic separate.

Key Requirements at a Glance

Use this checklist before you start. It summarizes the requirements and what to check.

Limitations and When This Setup Does Not Apply

Not every store can use this integration. The main limits come from Shopify plan access, domain rules, and theme settings.

• Localhost is not allowed. Security restrictions block localhost and similar local addresses.
• Changing development domains may fail. SeaText needs a stable URL to associate traffic with your account.
• Plans without code editing cannot install the snippet. Confirm your Shopify plan supports apps and custom code.
• Themes that block code edits may not work. If your theme does not allow editing, contact the theme developer or switch to a compatible theme.
• Each website needs a separate account. One account cannot cover multiple primary domains.

Also, the AI remains inactive until you activate it. The connection does not change your storefront on its own. You must choose the agents you want to run.

Common Questions and Troubleshooting

Do I need coding experience?

No. The steps are copy, paste, save, and test. Your SeaText account gives you the code and instructions.

Will SeaText slow down my store?

The script is part of your theme, and the AI stays inactive until activated. Test one page first. Then turn on only the agents you need.

Can I use the same SeaText account for multiple stores?

No. Each domain needs its own account. This keeps configuration separate and avoids traffic mismatches.

Can I use localhost for testing?

No. Localhost is restricted for security reasons. Use a real domain, such as dev.yourstore.com, for development.

What if I switch themes?

Install the snippet again in the new theme. The process is the same.

How do I know the integration is working?

Preview a product page. Open browser developer tools and inspect the product description HTML. Check that the data attribute is present.

Is the integration secure?

The installation process is secure. The AI remains inert until activated, which protects your website content.

What if my theme blocks code editing?

Contact the theme developer. If the theme cannot be edited, switch to a theme that supports code changes. Then install the snippet again.

No, SeaText is not a cold outreach platform. It does not send emails, manage sequences, or scrape contact lists. But if you run cold outreach campaigns that drive traffic to your website, SeaText can make those visits more likely to convert. It rewrites your landing pages in real time to match the visitor's intent and source, and it can engage them with an AI sales chat agent that books meetings.

What Is Cold Outreach and What Tools Do You Need?

Cold outreach means contacting someone who hasn't opted in to hear from you. Common channels include email, LinkedIn, phone calls, and direct messages. To run cold outreach effectively, you need tools for:

• Finding prospects (lead lists, scrapers)
• Managing campaigns (email sequences, CRM)
• Delivering messages (SMTP, LinkedIn automation)
• Tracking opens, clicks, replies

SeaText does none of those things. It is a conversion optimization tool for your website, not a prospecting or messaging tool.

What SeaText Actually Does

SeaText is a set of autonomous AI agents that work on your website in real time. The core function is to adapt your page content to each visitor. For example, when someone clicks a Google Ads keyword, SeaText rewrites the landing page headline, body copy, offer, and CTA to match that exact search term. According to the SeaText source pack, this approach has driven a +35% conversion lift for clients.

SeaText also provides agents for:

• Visitor Source Rewrites – Match landing page headlines to the referrer campaign (e.g., a cold email link).
• AI Personalization – Adapt site copy to visitor context like device, time, or behavior.
• Free AI Website Chat – An autonomous sales chat agent that can book and close leads.
• Bot Protection – Detect and recover wasted ad spend from bot clicks.
• AI SEO Content Factory – Publish indexed Q&A pages to attract long-tail search traffic.

All of these agents are designed to increase conversion rates on existing traffic, not to generate new outreach opportunities.

How SeaText Can Help With Outreach-Driven Traffic

If your cold outreach sends people to a landing page, SeaText can improve what happens after the click. Here are the specific ways it helps:

Visitor Source Rewrites

When a prospect clicks a link from your cold email, SeaText can detect the referrer campaign and rewrite the landing page headline to match. For example, if your email subject line is “Free SEO Audit,” SeaText can change the headline to “Claim Your Free SEO Audit” instantly. This makes the page feel continuous with the email, which increases trust and conversion.

AI Personalization

Beyond the source, SeaText can adapt copy based on the visitor’s location, device, or past behavior. If you know a prospect is in a specific industry, you can have the page reference that industry automatically.

Free AI Website Chat

Once a prospect lands, the AI chat agent can engage them without human effort. It can answer questions, schedule a demo, or hand off to a sales rep. This is especially useful for cold outreach because you can capture leads even when your team is offline.

AI SEO Content Factory

This agent builds long-tail FAQ pages that answer the exact questions your prospects are searching. Those pages can bring in organic traffic from people who are already in the market, complementing your cold outreach efforts.

How to Use SeaText With Your Cold Outreach Campaigns

Here is a simple process to integrate SeaText with cold outreach:

1. Create a dedicated landing page for your cold outreach offer. It can be a simple page with a headline, form, and CTA.
2. Add SeaText to your site in under one minute. The source pack says it takes less than a minute.
3. Activate the Visitor Source Rewrite Agent and configure it to match your campaign names. For example, set up a rewrite for “cold-email-audit” that changes the headline to “The Audit You Requested.”
4. Activate the AI Website Chat Agent to capture leads who don’t fill the form.
5. Send your cold outreach with a link that includes a UTM parameter or referrer ID. SeaText will read that and rewrite the page accordingly.
6. Monitor conversion rates in the SeaText dashboard. The source pack mentions a +35% conversion lift average.

This process works for any outreach channel that sends traffic to your site—email, social media DMs, or LinkedIn messages.

Key Facts About SeaText for Lead Generation

Limitations: When SeaText Won't Help With Cold Outreach

SeaText is not a replacement for cold outreach tools. It cannot:

• Find or scrape prospect contact information.
• Send emails, messages, or calls.
• Manage sequences or follow-ups.
• Track replies or schedule meetings (except through the chat agent).

If your cold outreach does not drive traffic to a website (e.g., you only call prospects), SeaText has no role. Also, if you don't have a landing page or a form to convert, SeaText's personalization cannot help.

Alternatives for Cold Outreach Software

SeaText is complementary to, not a substitute for, dedicated cold outreach platforms. You will still need a tool like Lemlist, Outreach, SalesLoft, or HubSpot Sales Hub to execute your campaigns. SeaText works best when paired with such tools to optimize the landing page experience.

Frequently Asked Questions

Does SeaText integrate with my email outreach tool?

SeaText does not have a direct integration with email platforms. It works by detecting URL parameters or the referrer header. You can pass UTM parameters from your email tool, and SeaText will rewrite the page based on those.

Can SeaText help me write cold email copy?

No. SeaText writes website copy, not email copy. However, the AI SEO Content Factory can generate content for your website that answers prospects' questions, which you can then reference in your outreach.

How much does SeaText cost?

The source pack mentions you can get up to 5 keywords free. For full pricing, you need to visit the pricing page. There is no list price in the source pack.

Will SeaText slow down my landing page?

The source pack claims “0ms zero-flicker URL split tests” for the AI Split URL Testing agent, and the rewriting happens before the page loads. So speed impact is minimal.

Can I use SeaText for cold outreach on LinkedIn?

Yes, if your LinkedIn message includes a link to your site. SeaText will rewrite the page based on the referrer or a custom parameter. You can set up a campaign-specific rewrite for LinkedIn traffic.

Does SeaText replace a CRM?

No. SeaText is a conversion optimization tool, not a CRM. You still need a CRM to manage leads and track interactions.

What is the expected conversion lift from using SeaText with cold outreach?

Based on the source pack, the average conversion lift is +35%. That number comes from their Google Ads Landing Page AI, but similar lifts can be expected for other traffic sources if the personalization is relevant.

Start your audit in the right place

If SeaText fails to initialize on your Odoo site, the problem almost always lives inside the Website module, not inside the SeaText account itself. The script SeaText gives you is a JavaScript snippet, and Odoo ships that snippet onto a public page through the Embed Code block. So every Odoo setting that controls the Website module, the block system, or how custom scripts run on a page can stop SeaText before it starts. Use the checklist below to work through the most common causes first, then move to the deeper checks only if the basic ones pass.

Before you touch anything, open a fresh browser tab in incognito mode and load the page where SeaText should appear. An Odoo initialization failure often looks like a missing widget, a blank block, or a script that never logs activity. Knowing what you see (or do not see) helps you place each check in the right order.

Diagnostic sequence: the checks to run, in order

Follow this order so you do not waste time on advanced settings before the basics are confirmed. Each step depends on the one above it.

1. Confirm you are inside the Website module

SeaText installs through the Odoo Website module, not through the backend Apps list. From your Odoo dashboard, click Website in the main app switcher. If the Website app icon is missing, your Odoo plan does not include it, and SeaText cannot be added through this method.

2. Open the page in edit mode and locate the Embed Code block

Navigate to the specific page where SeaText should run and click Edit. In the editing panel on the right, scroll the Blocks menu down to the Dynamic Content section. The block you want is labeled Embed Code. If it is not there, your Odoo build or installed theme has hidden the dynamic content blocks; that alone can prevent initialization.

3. Verify the SeaText code snippet was saved inside the block

Click the Embed Code block on your page, then click Edit in the right panel. The pop-up window that opens should contain the JavaScript snippet copied from your SeaText account. If the field is empty, SeaText never had a snippet to load, and that explains the failure. Paste the snippet from SeaText and click Save.

4. Check the Visibility setting on the block

Right after saving the snippet, look at the Visibility section inside the same pop-up. SeaText is designed to run on every visitor session, so the block must not be set to Hide on Desktop unless that is your deliberate choice. A desktop-only audit that loads the page on a laptop will see nothing if this toggle is on. Toggle it off and click Save again.

5. Recheck the snippet for stray characters

Odoo's snippet field can swallow leading or trailing spaces when you paste. Open the block again and inspect the start and end of the snippet. If the script begins with whitespace or is missing the closing </script> tag, the browser will silently refuse to run it. Compare the saved text byte-for-byte against what SeaText shows in your account dashboard.

Odoo settings that often block initialization

Beyond the block-level checklist above, three Odoo-wide settings are worth a closer look when SeaText still will not start.

Domain and URL mismatch with your SeaText account

Each SeaText account is linked to a single primary URL. If the domain in your SeaText account does not match the live domain of your Odoo site, the script will load but SeaText will not associate traffic with your account, so nothing initializes. SeaText also restricts development URLs such as localhost for security reasons. If you are testing on a staging or local URL, the script will not fire.

JavaScript conflicts from other modules

Odoo sites often run several third-party modules at once. If another app loads its own JavaScript that targets the same area of the page, SeaText's snippet may be overridden before it initializes. Open your browser's developer console, reload the page, and look for JavaScript errors or duplicate script tags. If you see conflicts, disable the other module temporarily and reload to confirm SeaText initializes.

Cache and server restart state

Odoo caches both frontend assets and backend module lists. After you save the Embed Code block, clear your browser cache and, if you self-host Odoo, restart the Odoo service so the asset bundle rebuilds. Without this step, Odoo can serve an older version of the page that does not include the new snippet.

Decision rule: when each fix applies

Use the table below to match what you see in Odoo to the setting you should change next.

Step-by-step process for a clean initialization

If you want one repeatable workflow rather than ad-hoc fixes, run this sequence end to end the next time you install SeaText on a new Odoo site.

1. Log into your SeaText account and copy the JavaScript snippet SeaText shows for your primary domain.
2. In Odoo, open the Website module and navigate to the page where you want SeaText to run.
3. Click Edit, then drag an Embed Code block from Dynamic Content into the page.
4. Click Edit on the new block, paste the SeaText snippet into the pop-up, and click Save.
5. In the same pop-up, confirm Hide on Desktop is off, then click Save again.
6. Reload the page in an incognito window and open the browser console.
7. If no SeaText activity appears, walk through the diagnostic sequence above before contacting support.

Practical scenarios

Scenario A: new Odoo site, no SeaText activity anywhere

You just published a fresh Odoo site and the page shows no SeaText element at all. In nine out of ten cases, the Embed Code block was added but the snippet field is empty, or the block was hidden on desktop. Open the block in edit mode first and verify both conditions before looking at deeper causes.

Scenario B: SeaText worked yesterday, broken today

If SeaText stopped initializing after a working install, something in Odoo changed. Check whether a new module was installed, whether the theme was updated, or whether Odoo pushed a bugfix release. Each of these can wipe the asset bundle or add a script that conflicts with SeaText. Restart the Odoo server, clear the cache, and reload.

Scenario C: works on staging, fails on production

Domain mismatch is the usual cause here. SeaText ties each account to a single primary URL, so a snippet tied to your staging subdomain will not initialize on the production domain. Either point production traffic at the staging account, or create a separate SeaText account for production and paste that account's snippet into a fresh Embed Code block on the live site.

Limitations of this checklist

The settings above cover SeaText's documented installation path through the Odoo Embed Code block. They do not cover every possible Odoo error. If you see Python tracebacks, AttributeError messages, or missing field errors in the Odoo backend, those point to a broken Odoo module rather than a SeaText problem. A Reddit thread about Odoo initialization failures describes a long-forgotten module corrupting the registry; that kind of issue is fixed by removing or repairing the offending module, not by changing SeaText settings. Likewise, Odoo version-specific errors (such as manifest depends problems) live in the Odoo source itself and need an Odoo developer to resolve.

This checklist also assumes your Odoo plan includes the Website module. On Odoo plans that ship only the backend apps, SeaText's documented Embed Code path is not available.

Key facts

Frequently asked questions

Do I need to install SeaText as an Odoo app?

No. SeaText installs as a JavaScript snippet inside an Embed Code block in the Website module. There is no separate app to install from the Odoo Apps menu for this path.

Why does the page look correct in the editor but empty on the live site?

Most often the Hide on Desktop toggle is on, or the asset bundle was not rebuilt. Uncheck the toggle, clear your cache, and restart the Odoo server if you self-host.

Can I use one SeaText snippet on multiple Odoo domains?

Not directly. Each SeaText account is tied to a single primary URL. Create a separate SeaText account for each domain and paste that account's snippet into its own Embed Code block.

Why will SeaText not initialize on localhost?

SeaText restricts development URLs such as localhost for security reasons. Test on a real, publicly resolvable domain, or use a separate account for staging.

How do I tell if SeaText has actually initialized?

Open the browser developer console, reload the page, and look for SeaText network requests or console messages. If none appear, the script was not loaded, and the cause is one of the block-level or domain checks above.

Does the Odoo Apps menu show SeaText?

SeaText is not a native Odoo app on this install path, so it will not appear in the Apps menu. Confirming its presence in the Apps menu is not a valid check.

How SeaText can help

SeaText provides a JavaScript snippet that you paste into Odoo's Embed Code block, and the script stays inert until you activate it from your SeaText account. This means failed initialization is almost always a block, domain, or cache problem in Odoo rather than a SeaText service outage. The diagnostic sequence above walks you through every SeaText-controlled variable so you can isolate the cause without guessing. If you need a second pair of eyes on a stubborn installation, SeaText's support team can review your saved snippet and confirm whether your account domain matches the URL SeaText sees on the request.

If SeaText AI doesn't connect, check these four things first: your internet connection, the Shopify app and account setup, the accuracy of your API key or code snippet, and the store URL linked to your SeaText account. Most connection failures come from a mismatch between the code snippet and the account's primary URL, not from an outage. Work through the checklist in order; it should take five minutes.

Quick-Start Readiness Checklist

Use this order. It moves from the simplest cause to the most likely hidden one.

• Internet connection: Open your store in a normal browser. If it loads, move on.
• Shopify integration and account: Confirm you have a SEATEXT AI account and that the JavaScript snippet is installed in your Shopify theme.
• API key or code snippet: Compare it to the one in your SEATEXT AI account. Check for missing characters or extra spaces.
• Store URL: Confirm it matches the primary URL on that account. Each SeaText account is tied to a single primary URL.
• Code placement: The snippet goes in Layout/theme.liquid, not in a random theme file.
• Save and test: Click Save and preview a product page. Use browser developer tools to verify the data attribute.

Why This Checklist Works

SeaText connects through a JavaScript snippet placed in your Shopify theme. If that snippet cannot load, SeaText has nothing to talk to. A connection error almost always means the page loaded before the snippet, the snippet is on the wrong domain, or the account behind it isn't active.

Checking the internet connection first clears away simple network problems. Checking the Shopify account and installation next makes sure the setup step actually happened. Then the code snippet and store URL checks handle the two most common causes: a typed-in key or a domain mismatch.

How SeaText AI Connects to Your Store

SeaText is not a separate app that runs on your phone or desktop. It is a script you add to your website. On Shopify, you put that script into your theme's layout file so that every page can load it.

1. Create a SEATEXT AI account. You need this before you can install anything.
2. Copy the JavaScript code from your SEATEXT AI account.
3. In Shopify admin, go to Online Store > Themes.
4. Click the three-dot menu next to your active theme and choose Edit code.
5. Open the Layout folder and click theme.liquid.
6. Paste the code snippet into that file.
7. Click Save.

SeaText also provides a product-description tag. That step is optional for basic connection, but it is required if you want the product description optimization to work. The source says to wrap the product description output code with the SEATEXT tag and verify the data attribute appears.

Step-by-Step: What to Check First

1. Internet Connection

Open your store in a private or normal browser window. If the page loads, your connection is fine. Try another device or network if it doesn't.

2. SeaText Account and Shopify Installation

Go to your SEATEXT AI account and confirm one exists for the domain you're using. The source says: Before you can install the script, you need a SEATEXT AI account. If you have not created an account, the snippet has no place to send data.

In Shopify, navigate to Online Store > Themes. Click the three dots next to the active theme and select Edit code. Look for the snippet in Layout/theme.liquid.

3. API Key or Code Snippet Accuracy

Copy the snippet or API key directly from the SEATEXT AI account rather than retyping it. Compare the first few and last few characters. A single space, comma, or changed character can break the connection.

4. Store URL and Domain Match

Each SEATEXT AI account is linked to a single primary URL. If you are testing on a staging domain or a different store URL, the script will not connect to that account.

Check the exact URL in your browser address bar. It should match the primary URL in your SEATEXT AI account. Include or exclude www as the account expects.

5. Save and Test

After pasting the snippet, click Save in the Shopify theme editor. Then preview a product page. Use your browser's developer tools to inspect the HTML source and look for the data attribute described in SeaText's documentation.

Common Connection Mistakes

Key Facts About SeaText AI Installation

Limitations and Exceptions

The checklist above works for standard Shopify stores. It does not apply when:

• You are using localhost or a dynamic development domain. SeaText restricts or may fail on these.
• You need SeaText on multiple domains. You must create a separate account for each one.
• You are using a non-Shopify platform. The integration guide we cite is for Shopify; other platforms have their own install steps.

Also, the AI stays inert until you activate it. If everything is installed but nothing changes on your site, check that you have activated the agents you want. The homepage copy says Activate the autonomous agents you need after adding SeaText to your site.

Frequently Asked Questions

Why does localhost not work with SeaText?

SeaText restricts development URLs such as localhost for security reasons. Use a valid, real domain instead.

Can I use one SeaText account for my staging and live sites?

No. Each account is linked to a single primary URL. Dynamic development domains may also fail because SeaText cannot reliably associate traffic with your account.

Do I need a separate account for each website?

Yes. The source says to create one account for each website if you use SeaText on multiple websites.

Where exactly do I paste the SeaText snippet in Shopify?

In Shopify admin, go to Online Store > Themes. Click the three dots next to your active theme and select Edit code. Open the Layout folder, then paste the snippet into theme.liquid.

How do I test if SeaText is connected?

Save your changes, preview a product page, and inspect the HTML source with browser developer tools. Look for the data attribute described in SeaText's documentation.

What if SeaText is installed but nothing happens?

Check that you activated the agents you want. The AI remains inert until activated.

Is it safe to paste SeaText code into my theme?

SeaText says the installation process is secure and that the AI remains inert until activated, which keeps your website content safe before activation.

Your Next Step

If the checklist still doesn't fix your connection, go back to the official Shopify Integration guide. That page has the exact code placement steps and the domain rules that most connection errors violate. Do not try to guess the snippet format; use the one from your account.

Short answer: yes, but only a small, specific set of Shopify settings matters. SeaText AI doesn't require you to change tax rates, shipping profiles, or payment gateways. It requires the ability to edit your Shopify theme code, an active theme, a SeaText AI account, and a valid real domain. The official integration works by pasting a JavaScript snippet into your theme.liquid file and optionally tagging product descriptions with a data attribute. Once you can do those things, you're ready.

If you're comparing this to an app-store install, the key difference is this: SeaText's documented setup is a code snippet, not a Shopify app. You don't need to find it in the App Store or configure App settings. You need code-editing access.

SeaText AI Shopify Connection Checklist

Use this checklist before you start. Each item below is based on the official SeaText Shopify integration guide.

• ☐ A Shopify store with an active theme.
• ☐ Shopify admin access that allows theme code editing (Online Store > Themes > Actions > Edit Code).
• ☐ A SeaText AI account. You need it before you install the script.
• ☐ A valid, real domain. Localhost is restricted.
• ☐ The JavaScript code from the SeaText integration section.
• ☐ A saved copy of theme.liquid after pasting the code.
• ☐ For product description optimization: the correct data attribute placed around the description output in your product template.

Why These Shopify Settings Matter

Theme editing permission is the main “specific setting.” Without it, you cannot add the code. The script lives in the layout file that every Shopify page uses. If you can't edit that file, the installation stops before it starts.

The SeaText AI account is not exactly a Shopify setting, but it is a prerequisite. The code is tied to your account, and the account is tied to a primary URL. Skipping this step means you have nothing to paste.

A real domain matters because SeaText blocks development URLs for security. A localhost URL won't work, and dynamic development domains may fail because SeaText can't reliably associate traffic with your account.

What changes if you ignore these? You'll see a script that doesn't load, a product page without the data attribute, or traffic that never gets connected to your account. The checklist is not bureaucracy; each item prevents a specific failure.

How the Connection Works

SeaText connects at the theme layer. You log into Shopify, open Online Store > Themes, choose the active theme, click Edit Code, and open layout/theme.liquid. You paste the JavaScript snippet from SeaText's integration page and save. The script then loads as part of your theme.

SeaText's installation process is secure, and the AI remains inert until activated. In plain language: adding the code does not automatically start rewriting your store. You activate agents later from your SeaText dashboard.

For product-specific work, you go one level deeper. Shopify's product page is rendered by product.liquid or product-template.liquid. You find the output that displays the description and wrap it with the data attribute provided by SeaText. This gives SeaText a clear hook to optimize product descriptions. After saving, preview a product page and inspect the HTML to confirm the attribute is there.

Step-by-Step Setup for a Standard Shopify Store

1. Create a SeaText AI account if you don't already have one.
2. Log into your Shopify admin.
3. Go to Online Store > Themes.
4. Click Actions > Edit Code for the theme you want to connect.
5. Open the Layout folder and select theme.liquid.
6. Copy the JavaScript code from the SeaText integration section.
7. Paste the code into theme.liquid.
8. Click Save.
9. If you also want product description optimization, open product.liquid or product-template.liquid. Find the file in your theme that renders product descriptions.
10. Locate the product description output and wrap it with the data attribute from SeaText.
11. Save and preview a product page.
12. Use browser developer tools to confirm the data attribute is present in the HTML source.

What Counts as a “Specific Shopify Setting” Anyway?

When we say “specific Shopify settings,” we mean the ones that let you modify your theme. SeaText does not use checkout settings, shipping zones, or tax rules. The official guide only touches the Online Store > Themes area and, for product descriptions, the product template files.

You also don't need to generate a Shopify API key for this setup. The documented path is a JavaScript snippet, not API credentials. If Shopify ever asks you to authorize an app connection, that would be a separate route from the official code-snippet method.

The Optional Product Description Tag: When to Use It

This part matters if you plan to use SeaText's product description optimization. The data attribute gives SeaText a reliable place to read and modify the description. Without it, the relevant agent has no obvious hook.

There is a trade-off: wrapping the wrong output could hide the description or break the product page if the markup is incorrect. The official guide tells you to test. If you're not comfortable editing Liquid, ask a developer to do this one step. The rest of the integration can still work without the product tag, but product-copy features won't have their target element.

Shopify Readiness Decision Rule

Use this simple decision framework instead of guessing.

• If you can edit theme code → you can complete the base connection.
• If you have a SeaText account and a real domain → you can copy the script and connect.
• If you use product description optimization → add and verify the data attribute.
• If your site runs on localhost → stop and use a valid public domain.
• If you run a development domain and a production domain → create separate SeaText accounts for each.
• If you manage multiple websites → create one account per website.

This decision rule has one clear boundary: it only applies to the standard Shopify theme-based integration documented by SeaText. If Shopify changes its theme editor or if you use a custom headless setup, re-check the current official guide.

Key Facts at a Glance

Limitations and Exceptions

SeaText's Shopify integration has clear boundaries. Here are the exceptions where the basic checklist doesn't apply.

• Localhost won't work. The system restricts development URLs for security. You need a valid, real domain.
• Dynamic development domains may not work. SeaText might not be able to reliably associate traffic with your account if the host changes often.
• One account per domain. If you need SeaText on a dev site and a production site, create separate accounts. This keeps traffic attribution clean.
• Multiple websites need multiple accounts. Each store or website you connect gets its own account linked to its own URL.
• The AI stays inactive until you activate it. Adding the script is safe, but nothing changes until you turn on agents in SeaText.
• Shopify plan limits are outside this list. If your Shopify admin doesn't show Edit Code, check your theme permissions and plan type with Shopify. SeaText's guide assumes standard Shopify theme access.

Frequently Asked Questions

Do I need to install SeaText from the Shopify App Store?

No. The official integration guide asks you to paste a JavaScript snippet into theme.liquid. That's a code-and-theme workflow, not an app-store installation. If you later use an app-based route, Shopify will guide you through its own authorization, but it isn't part of the documented SeaText setup.

What Shopify setting is most important?

Theme code editing. The entire integration depends on opening theme.liquid and saving a change. If you use a managed Shopify theme where you can't edit code, get a developer or work with a theme that allows it.

Can I connect a staging site?

Not if it's localhost. Dynamic development domains may also fail because SeaText can't reliably associate traffic with your account. Use a stable, real domain for each account.

Why can't I use the same SeaText account on two shops?

Each account is linked to a single primary URL. Using the same account on another domain means the URL association won't match, and traffic can't be attributed correctly. Create one account per website.

How do I verify the product description tag works?

Save the product template, preview a product page, and inspect the source with browser developer tools. You should see the data attribute present in the description output.

Does adding the script require developer help?

Only if you're uncomfortable editing Liquid files. The base step is pasting code into theme.liquid. The product tag step requires a little more precision, so a developer can help if needed.

For the full current instructions, see the official SeaText Shopify Integration page.

When a visitor arrives from a Google ad, a Meta campaign, an email newsletter, or a referral article, they carry context: the keyword they searched, the ad copy they saw, the email subject line they opened. If your landing page ignores that context, you break the promise and lose the conversion. The fix is to read the traffic source before the page loads and adapt the headline, offer, product blocks, and call to action so the page feels like it was built for that specific click.

SeaText does this automatically. It detects the campaign link (UTM parameters, gclid, fbclid) or the referring domain, then either sends the visitor to an existing page that matches the source or rewrites the current page in real time — swapping headlines, key copy, offers, product recommendations, and CTAs — so the page continues the exact promise from the ad, email, or article. Results are tracked by traffic source, page, keyword, and version so you can see which matches actually convert.

What traffic-source personalization actually means

Traffic-source personalization is the practice of changing what a visitor sees on a landing page based on where they came from. Instead of showing every visitor the same generic page, you match the page's message to the specific campaign, keyword, email, or referral that drove the click. The goal is message continuity: the headline, offer, proof points, and CTA should echo the exact language and promise that convinced the visitor to click.

This goes beyond simple UTM-based content swaps. Modern implementations read the full referrer context — campaign ID, keyword, ad creative, email segment, referring article topic — and make structural changes: swapping product blocks, reordering proof elements, changing the primary CTA, even adjusting the page layout. The changes happen before the page renders, so the visitor never sees a flicker or redirect.

How the detection and rewrite process works

1. Identify the source. The system reads the incoming request for campaign parameters (gclid, fbclid, utm_source, utm_medium, utm_campaign, utm_term, utm_content) and the HTTP referrer header.
2. Classify the intent. Based on the source data, the system determines the visitor's likely intent: a specific keyword search, a retargeting ad, a promotional email, a blog referral, or organic social.
3. Select or generate the variant. The system either routes to an existing page variant that matches the source or rewrites the current page's headline, subhead, body copy, offer, product recommendations, proof elements, and CTA to align with the detected intent.
4. Render the personalized page. The changes are applied server-side or at the edge before the HTML reaches the browser, so there is no layout shift or flash of generic content.
5. Track and attribute. Every visit, engagement, and conversion is logged against the traffic source, keyword, and page variant so you can measure lift and iterate.

SeaText implements this flow automatically. It reads the campaign link or referring page, then either sends visitors to the most relevant existing page or rewrites the message, proof, offer, and CTA so the page continues the story they just clicked. Results are tracked by traffic source, page, keyword, and version.

Key facts about SeaText's traffic-source personalization

Step-by-step: setting up traffic-source personalization

1. Install the script. Add the SeaText snippet to your site's <head>. This takes under a minute and requires no code changes to your pages.
2. Activate the Visitor Source Rewrite agent. In the SeaText dashboard, enable the "Visitor Source Rewrites" agent. This agent handles matching pages to ads, emails, articles, and referrals.
3. Connect your ad accounts (optional but recommended). Link Google Ads and Meta Ads accounts so the system can read campaign names, keywords, and ad creative directly for more precise matching.
4. Define your page variants or let the AI generate them. You can create specific page versions for major traffic sources (e.g., a "Google Ads — branded keywords" variant, a "Meta retargeting" variant), or let the AI rewrite headlines, offers, and CTAs on the fly based on the detected source.
5. Set up conversion tracking. Ensure your conversion events (purchases, signups, form submits) fire through SeaText so results are attributed by traffic source, keyword, and page variant.
6. Review and refine. After 1–2 weeks of traffic, check the dashboard for performance by source. Identify high-traffic sources with low conversion and adjust the matching rules or create dedicated variants.

Verification step: Visit your own site via a test Google Ads click (use the ad preview tool) or a test email link with UTM parameters. Confirm the headline, offer, and CTA reflect the campaign you came from.

Main approaches and trade-offs

Choose AI rewrite if you have dozens of active campaigns, limited design/dev bandwidth, and want continuous optimization without manual upkeep. Choose manual variants if you run a handful of strategic campaigns where every word must be approved. Choose UTM-based blocks if you already have a personalization stack and only need to swap discrete sections. Avoid separate pages per campaign unless you have a dedicated team and a strong reason to isolate each experience.

Practical scenarios where source personalization moves the needle

Google Ads keyword mismatch

A visitor searches "enterprise project management software" and clicks your ad. Your generic landing page leads with "Manage tasks easily." The rewrite swaps the headline to "Enterprise-grade project management for 500+ teams," surfaces security certifications, and changes the CTA from "Start free trial" to "Book a demo." The page now matches the search intent.

Meta retargeting vs. prospecting

A prospecting ad promises "Discover the fastest way to onboard clients." A retargeting ad says "Still evaluating? See why 200 agencies switched last month." The same landing page rewrites its headline, proof bar, and CTA to match whichever ad the visitor clicked.

Email segment personalization

Your "abandoned cart" email links to the product page. The referrer tells SeaText the visitor came from that email. The page highlights the exact product left in cart, shows a "Complete your purchase" CTA, and adds a limited-time shipping offer — without you building a separate page.

Referral article context

A tech blog reviews your category and links to your site. The referrer domain and article topic signal the visitor is in research mode. The page leads with a comparison table, third-party reviews, and a "See how we compare" CTA instead of a hard sell.

International paid traffic

You run Google Ads in Germany and Japan. SeaText detects the campaign's target country, translates the page into German or Japanese, adapts the offer and proof points for local norms, and tracks conversions by market — all from one page.

Limitations and when this advice doesn't apply

• Privacy regulations. In jurisdictions with strict referrer-stripping or consent requirements (e.g., GDPR with strict ePrivacy enforcement), referrer data may be unavailable. UTM parameters remain reliable if you control the links.
• Direct and dark traffic. Visitors who type your URL, use bookmarks, or come from apps that strip referrers (some email clients, messaging apps) appear as "direct." You can't personalize for a source you can't see.
• Single-page applications with client-side routing. If your site rewrites the URL without a full page load, the initial referrer may be lost. SeaText captures the original referrer on first load, but subsequent "virtual" page views need explicit tracking.
• Brand-compliance lock-down. If legal requires every headline and claim to be pre-approved, AI-generated rewrites need a review gate. SeaText lets you approve variants before they go live.
• Very low traffic. If a source sends fewer than ~100 visits/month, statistical tracking by source/keyword/variant will be noisy. Aggregate or pause personalization for those sources.

Terminology quick reference

• Referrer / Referring page: The URL the visitor was on immediately before clicking to your site. Available via the HTTP Referer header (sic).
• UTM parameters: Standard query strings (utm_source, utm_medium, utm_campaign, utm_term, utm_content) appended to links to identify marketing campaigns.
• gclid / fbclid / msclkid: Auto-appended click IDs from Google Ads, Meta Ads, and Microsoft Ads that carry campaign, ad group, keyword, and creative IDs.
• Message match: The degree to which a landing page's headline, offer, and CTA mirror the ad, email, or link that drove the click.
• Multi-armed bandit: An algorithm that dynamically allocates more traffic to better-performing variants while still exploring others, converging faster than fixed 50/50 A/B splits.
• Edge rendering: Executing personalization logic at a CDN edge node before the HTML reaches the browser, eliminating flicker.

FAQ

Do I need to create separate pages for each traffic source?

No. SeaText can rewrite a single page in real time for each source. You can also create dedicated variants for your top sources if you want full control, but it's not required.

How does the system know which keyword triggered a Google Ads click?

Google Ads appends a gclid parameter. When you link your Google Ads account, SeaText reads the keyword, campaign, and ad creative associated with that click ID and uses it to personalize the page.

Will this hurt my SEO or cause cloaking issues?

No. The personalization happens for paid and referred traffic where the referrer or campaign parameters are present. Organic search visitors see the base page. Search engine crawlers typically don't send campaign parameters, so they index the default version.

Can I review and approve AI-generated rewrites before they go live?

Yes. SeaText lets you set guardrails and approve variants before they're served to visitors. You can also restrict AI rewrites to specific page sections.

What if a visitor comes from a source I haven't configured?

They see the base page — your default headline, offer, and CTA. You can add rules for new sources anytime.

How do I measure whether personalization is actually working?

The dashboard shows conversions, conversion rate, and revenue by traffic source, keyword, and page variant. Compare the personalized variant's performance against the base page for the same source.

Does this work for email campaigns from any ESP?

Yes, as long as your email links include UTM parameters or a recognizable referrer domain. SeaText reads the utm_source, utm_medium, utm_campaign values and the referrer to identify the email campaign.

Next steps

Start by auditing your top five traffic sources in Google Analytics or your ad platforms. Note the keywords, ad copy, email subject lines, and referral topics driving clicks. Then install SeaText, activate the Visitor Source Rewrite agent, and let it build the first round of matches. Within a week you'll have data on which sources benefit most from personalization — and you can refine from there.