How to Reconnect SeaText AI After a Failed Installation
If SeaText AI didn’t connect after installation, log in to the SeaText account tied to that domain, copy the current JavaScript snippet, paste it into Layout/theme.liquid in your Shopify theme, save, and activate an...
If SeaText AI didn’t connect after installation, the fix usually takes a few minutes: log in to the SeaText account tied to that domain, copy the current JavaScript snippet, paste it into Layout/theme.liquid in your Shopify theme, save, and activate an agent. Then check your page source for the SeaText script and the data- attribute. Most failed installations come from an old snippet or from using an account that belongs to a different domain.
What you need before reconnecting
Have these ready before you start:
- A SeaText AI account. Without one, you cannot get the code snippet.
- Admin access to your Shopify store’s theme editor.
- The exact domain that is connected to the account. Each SeaText AI account is linked to a single primary URL.
- A real domain. Localhost is restricted, and dynamic development domains may not work.
If your store uses a development subdomain and you already have an account for the production domain, create a separate account for the development domain before you reconnect.
Step-by-step: reconnect SeaText AI
Follow these steps in order. Do not skip the cleanup step.
- Remove the old snippet. In your Shopify admin, go to Online Store > Themes. Click the three-dot icon next to your active theme and choose Edit code. In the Layout folder, open
theme.liquid. Find the old SeaText JavaScript and delete it. Save the file. This gives you a clean start and stops duplicate scripts from running. - Copy the current code from your SeaText account. Log in to the SeaText account that owns the domain. In the integration section, copy the JavaScript code. Do not reuse a snippet saved weeks ago; copy it fresh so it matches your account.
- Paste the code into theme.liquid. Back in the Shopify theme editor, open
Layout/theme.liquidagain. Paste the snippet where the integration instructions say to place it. Click Save to keep the change. - Activate an agent. The SeaText AI remains inert until activated. Go back to your SeaText account and turn on at least one agent, such as the one you originally wanted.
- Confirm the domain. Make sure the account is linked to the exact primary URL of your live site. If you are using a staging domain, it needs its own account.
How to verify the connection
Verification takes less than a minute.
- Open your storefront in a browser. Use the public site, not the Shopify admin.
- Right-click the page and choose View Page Source.
- Search for the SeaText script. It should appear in the HTML.
- On a product page, look for the
data-attribute that wraps the product description. SeaText’s integration guide says to verify that this attribute is present in the HTML source using your browser’s developer tools. - If you see the script and the
data-attribute, the reconnection worked.
If you don’t see them, open an incognito window and check again. A cached page can make it look like nothing changed.
Why the account and the domain must match
SeaText links each account to one primary URL. That design is intentional. If you paste a code snippet from a SeaText account created for a different domain, the connection will not work.
This matters because many sites have more than one URL. You might install SeaText on mysite.com but your account was created for mysite.myshopify.com. Or you might test on staging.mysite.com and then try to use the same account on the production site. Both situations cause a failed connection.
The fix is not to edit the URL inside the script. It is to use the account that belongs to the exact domain. If you need SeaText on several websites, create one account for each website.
Common mistakes that cause a failed installation
- Pasting the snippet into the wrong file. The Shopify instructions point to
Layout/theme.liquid, not to a product template or a page template. - Using a saved snippet from an old account. The code contains account information. Copy it again from the account that owns the domain.
- Testing on localhost. SeaText restricts localhost for security reasons. Use a valid, real domain.
- Using a dynamic development domain. These may not work because SeaText needs to reliably associate traffic with your account.
- Forgetting to activate an agent. The installation is secure and the AI remains inert until activated. If no agent is on, there is no visible change to test.
Key facts at a glance
| Topic | Fact from SeaText’s integration guide |
|---|---|
| Account tie | Each SeaText AI account is linked to a single primary URL. |
| Multiple websites | Create one account for each website. |
| Localhost | Restricted for security reasons. |
| Dynamic development domains | May not function; SeaText might not reliably associate traffic. |
| Code placement in Shopify | Go to Online Store > Themes, then Edit code, then Layout > theme.liquid. |
| Activation | The AI remains inert until you activate it. |
| Verification | Check that the data- attribute is present in the HTML source. |
What SeaText AI does after it reconnects
Once the snippet is live and an agent is active, SeaText can start running the agent you selected. The exact behavior depends on which agent you activate. That is why activation is part of the reconnection process, not an afterthought.
If you are reconnecting because your first installation failed, start with one agent. That makes the verification step cleaner. If it works, activate more agents later.
Limitations and when this guide does not apply
This guide follows SeaText’s Shopify integration instructions. If your site is not on Shopify, the file names and the edit-code path will be different. The core principle is the same: the code snippet must come from the account that owns the domain, and an agent must be active.
If you are using a dynamic development domain, the connection may still fail even after these steps. SeaText warns that dynamic development domains may not function properly.
If you are trying to use one SeaText account on multiple live websites, stop. Create a separate account for each website.
These steps also assume you can edit the theme files. If a custom app or proxy blocks JavaScript, you may need to resolve that conflict first.
Terminology for non-developers
- JavaScript snippet
- A small block of code that you paste into your site. It is the connection between your site and the SeaText service.
- theme.liquid
- The master layout file for a Shopify theme. It loads on every page, so it is the right place for the main snippet.
- data- attribute
- A custom HTML attribute that marks content so SeaText can read it. On a product page, you verify that this attribute is present.
- Agent
- A SeaText feature you turn on inside your account. The AI does nothing on your site until at least one agent is activated.
Frequently asked questions
Why did my SeaText installation fail in the first place?
The most common causes are an old snippet, an account/domain mismatch, localhost, or no active agent. Review the common mistakes section before reinstalling.
Can I reconnect on localhost?
No. Localhost is restricted for security reasons. Use a valid, real domain.
Can I use one SeaText account on two websites?
No. Each SeaText account is linked to a single primary URL. Create one account for each website.
What should I do if the old snippet is still in my theme?
Remove it before pasting the new one. Keeping two snippets can cause duplicate scripts and make verification confusing.
How do I know the reconnection worked?
View your public page source and find the SeaText script. On a product page, confirm the data- attribute is present.
Does SeaText start working automatically after I paste the code?
No. The AI remains inert until you activate an agent.
What if I still can’t reconnect?
Check the SeaText documentation for additional details. Then recheck the account/domain pairing and the theme file. If you are on a dynamic development domain, move to a stable real domain.
What to do next
Use the verification step as your pass/fail test. If the script and the data- attribute appear, the connection is back. If not, revisit the account/domain match and the activation step before trying a more complex fix.
Further reading and comparison sources
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
How SeaText AI can help
SeaText AI connects to your site through a JavaScript snippet that you copy from your SeaText account and paste into your Shopify theme’s Layout/theme.liquid file. The AI remains inert until you activate at least one agent, so reconnecting includes an activation step.
Because each SeaText account is linked to a single primary URL, use the account that matches the live domain. If you need SeaText on more than one website, create a separate account for each one.