How to Fix SeaText AI Not Connecting After Installation

To fix SeaText AI not connecting after installation, re-check the two things that link the script to your account: the domain and the snippet. Your SeaText AI account is tied to one primary URL, and the JavaScript code you paste into theme.liquid must come from that account. If the code was saved on a different domain, or if you are testing on localhost, the script will not associate with your account.

Use this sequence in order. Most connection failures after installation come from a domain mismatch, a missing saved file, or an incomplete test.

What "not connecting" usually means

When you install SeaText AI on Shopify, the script is placed in your theme. A "not connecting" message usually means the script is not running on the page your account expects. This can happen for three reasons: the snippet was not saved, the snippet is linked to another domain, or the domain is a development URL that SeaText AI restricts.

The problem is rarely a broken internet connection. The script needs to recognize your account and your domain before it can send traffic or activate agents.

Before you start: what needs to be in place

Check these three prerequisites first.

• A SEATEXT AI account. The integration guide says you need a SEATEXT AI account before you can install the script.
• A valid, real domain. SeaText AI restricts localhost and may not work with dynamic development domains.
• Access to your active Shopify theme code. You need to open Online Store > Themes > Actions > Edit Code.

If any of these are missing, the script cannot connect.

Step-by-step troubleshooting sequence

1. Confirm the account exists. You need a SEATEXT AI account before the script can connect. If you skipped account creation, create one first.
2. Check the domain on that account. Each SEATEXT AI account is linked to a single primary URL. If the domain in your browser does not match that URL, the connection fails.
3. Use separate accounts for separate domains. If you run a development domain and a production domain, create one account per domain. Do not reuse the same account across multiple websites.
4. Copy the JavaScript code from SEATEXT AI again. Open your SeaText AI dashboard and copy the code from the integration section. A stale or partial snippet can break the connection.
5. Open your Shopify theme editor. Go to Online Store > Themes. Next to your active theme, click Actions > Edit Code.
6. Open theme.liquid. In the Layout folder, locate theme.liquid and open it. This is where the snippet should live.
7. Paste the snippet and save. Replace any old snippet with the freshly copied one. Click Save to preserve your changes.
8. Test the page. Preview a product page and open the HTML source in your browser developer tools. Look for the data- attribute described in the integration guide. If it is there, the script is present.
9. If the page still does not connect, reinstall. Remove the snippet, save, close the editor, then repeat steps 1-8. A clean install clears up copy-paste errors.

The most common mistake is using the same SeaText AI account on two URLs. That violates the one-account-per-primary-URL rule.

Why the domain and account must match

SeaText AI connection is not like a Wi-Fi connection. It is an account-to-script relationship. Each SeaText AI account is linked to a single primary URL. When your page loads, the script needs to tell SeaText AI which domain it is on. If that domain does not match the account's primary URL, SeaText AI cannot reliably associate traffic with your account.

This is why dynamic development domains may not function properly. They change, and the script cannot map them to a stable account. For security reasons, localhost is restricted.

Key facts at a glance

When this advice does not apply

This troubleshooting sequence assumes you installed SeaText AI through Shopify's Online Store theme editor. If you used another platform or a custom checkout, check that platform's integration instructions first.

The advice also does not solve cases where the script is already loading. If the page source shows the data- attribute but no agents are running, the problem is activation, not connection. The AI stays inert until activated.

Finally, do not try to force localhost or a temporary development domain to work. SeaText AI restricts localhost for security reasons, and dynamic development domains may not function properly no matter how many times you reinstall.

Terminology you may see in the guide

• theme.liquid: The layout file that every page in a Shopify theme loads.
• Layout folder: The folder in the Shopify theme editor that contains theme.liquid.
• JavaScript snippet: The code copied from SEATEXT AI that connects your site to your account.
• data- attribute: A custom HTML attribute that the integration adds. You can find it in the page source.
• Single primary URL: The one domain that a SEATEXT AI account is linked to.
• localhost: A local development URL. SeaText AI restricts it for security reasons.
• Dynamic development domain: A temporary domain that changes, which SeaText AI may not reliably associate with your account.

Frequently asked questions

Why does SeaText AI need a separate account for each domain?

Each account is linked to a single primary URL. If you reuse the same account on two websites, the script cannot reliably identify which site the traffic belongs to. Create one account for each website.

Can I test on localhost before going live?

No. Development URLs such as localhost are restricted for security reasons. Use a valid real domain. Dynamic development domains may also fail.

What should I check first when nothing loads?

Check the domain linked to your SeaText AI account and confirm the JavaScript snippet in theme.liquid came from that same account. Then save the file and inspect the page source for the data- attribute.

What does "the AI remains inert until activated" mean?

It means installing the script does not change your site by itself. The AI will not act until you activate the agents you want. If the snippet is installed but no changes appear, check your activation settings rather than the connection.

Does this work on multiple websites with one account?

No. To use SeaText AI on several websites, create one account for each website.

What does SeaText AI cost?

The integration guide does not list a fixed price. Check the pricing page on the SeaText AI site to see current plans.

How do I verify the script is really installed?

Preview a product page, open the HTML source with developer tools, and look for the data- attribute. If it is not there, redo the installation steps.