SeaText AI Won’t Connect After Installation? Use This Readiness Checklist

If SeaText AI doesn't connect after installation, don't reinstall yet. Work through the short readiness checklist in this article. First confirm the script is loading, the account matches the domain, and at least one agent is activated. In most cases this fixes the issue without touching the code again.

SeaText installs as a JavaScript snippet. You paste it into your website, usually in Shopify's theme.liquid file. If the snippet never loads, or loads on a domain that isn't linked to your account, SeaText can't connect. Here is what to check, in the order that finds broken connections fastest.

Symptoms that SeaText AI isn't connecting

Before changing anything, know what a failed connection looks like. Check these symptoms:

• You view the page source and don't see the SeaText JavaScript snippet.
• On a product page, the data attribute is missing from the HTML source.
• You saved the snippet, but nothing changes on the page.
• You installed it on localhost or a dynamic preview domain.
• The script works on one website but not on a second domain with the same account.

Why this happens: five common causes

You don't have a SeaText account yet

The integration guide says: 'Before you can install the script, you need a SEATEXT AI account.' The script is tied to an account. If you skip this step, there is nothing for the script to connect to. Create the account first, then copy the JavaScript snippet from inside that account.

The domain doesn't match your account

Each SEATEXT AI account is linked to a single primary URL. If you paste the snippet on a different domain, a subdomain, or a staging environment, SeaText won't know those visits belong to you. For a second website, create a second account.

You're using localhost or a dynamic development URL

Development URLs like localhost are restricted for security reasons. Dynamic development domains may also fail because SeaText can't reliably connect traffic to your account. Use a real, valid domain when you test.

The snippet is missing, misplaced, or not saved

In Shopify, open Online Store > Themes > Actions > Edit Code. Go to the Layout folder and open theme.liquid. Paste the snippet where the integration guide shows, then click Save. For product descriptions, the output must be wrapped with the correct tag. If you skip the save button, the code is gone the moment you leave the page.

The AI is installed but not activated

The guide says the AI 'remains inert until activated.' A loaded script is not the same as an active agent. Go into your SeaText account and check that you've activated at least one agent before you judge the connection.

The SeaText connection readiness checklist

Run these checks in order. Stop and fix the first problem you find, then move on.

1. Check the basic connection. Confirm the site loads in your browser and your internet connection is up. A blank page is not a SeaText problem.
2. Confirm the account exists. Open your SeaText account and copy the snippet from this session. Don't use a snippet from an old email or a coworker.
3. Check the primary URL. The domain where the script lives must be the same domain registered in your account.
4. Rule out localhost. Localhost is blocked. Any test site must run on a real, valid domain.
5. View the page source. In your browser, right-click and select View Page Source. Search for 'SEATEXT' or the script name.
6. Open theme.liquid. In Shopify, go to Online Store > Themes > Edit Code, then Layout > theme.liquid and compare the snippet to what the integration guide shows.
7. Save all changes. Click Save after pasting the snippet.
8. Activate an agent. Log into SeaText and turn on at least one agent. The script stays inert until you activate it.
9. Test the data attribute. Load a product page, open developer tools, and check that the data- attribute appears in the HTML source.
10. Clear cache and retest. Your site or browser may be serving an old version that doesn't contain the snippet.
11. Talk to support. If every check passes, go to the SeaText website and contact support with what you've tested.

Troubleshooting table: symptom, likely cause, quick fix

Key facts to know before you reinstall

Limitations and cases where this advice doesn't apply

The integration guide has hard limits you should know before troubleshooting too long:

• Multiple websites need separate accounts. The source says one account for each website.
• One primary URL per account. You can't point the same account at two production domains.
• Localhost and similar development URLs are blocked. This includes dynamic dev domains that can't be tied reliably to the account.
• The AI is inert until activated. If you activated nothing, a working connection may still have no effect.

If you installed SeaText on a custom platform that isn't Shopify, the general connection rules above still apply, but the exact file names will be different. Look for the global template or layout file where your site's head is rendered.

What the technical words mean

• Primary URL: the single web address linked to your SeaText account.
• theme.liquid: the Shopify layout file that controls your theme's global HTML structure.
• Data- attribute: a custom HTML attribute you can look for in the page source to verify the tag is working.
• Inert script: a script that loads but does not run any agent until you activate it in SeaText.

Frequently asked questions

Why does SeaText need one account per domain?

Because each account is linked to a single primary URL. The guide says this directly. If you want SeaText on multiple websites, you need multiple accounts.

Can I test SeaText on localhost?

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

How do I know the script is actually on my page?

Open the page in your browser, view source, and search for 'SEATEXT.' Then go to a product page and verify that the data- attribute is present in the HTML using browser developer tools.

I pasted the code but the page still doesn't change. Did I connect?

Maybe not. Check that you clicked Save, the snippet is in the correct file, and you've activated an agent. A loaded script is not the same as an active agent.

What should I do if I've tried everything and it still won't connect?

Go to the SeaText website and contact support. Before messaging, write down what you've checked: the domain, the account, the file, and the page source result. That will speed up the fix.