Seatext library

How to Check If SeaText AI Is Connected to Your Shopify Store

Open the SeaText dashboard and look for a green Connected status for your store’s domain. Then confirm the JavaScript snippet is saved in theme.liquid and that a product page shows the data- attribute when...

Your SeaText AI connection is working when two things are true: the SeaText dashboard shows a green Connected status for your store’s domain, and your Shopify theme contains the JavaScript snippet. To confirm the second one, open theme.liquid in Shopify admin or inspect a live product page. The whole check takes a few minutes.

If either part is missing, SeaText AI may not receive data from your store. A green status alone is not enough if the code was never saved or was added to the wrong theme.

What a proper connection actually means

A connected store is one where SeaText AI can associate traffic with your account. That is the core requirement. The installation notes are clear: the AI remains inert until activated, so showing Connected in the dashboard does not mean an agent is working.

If you ignore a failed connection, the dashboard can stay empty, product description tags may not work, and agents that depend on store data will have nothing to act on. A short check now prevents an integration that silently fails.

For most installs, the connection has two layers:

  • The main script in theme.liquid.
  • Any optional feature tags, such as the product description tag with a data- attribute.

You might see Connected while an optional tag is missing. The fix is not to reinstall the whole script. It is to add the missing tag and save.

Prerequisites before you test

  • You need a SEATEXT AI account before installing the script. If you don’t have one, create it first.
  • Use a real domain. Development URLs such as localhost are restricted.
  • Use one account per domain. Each account is linked to a single primary URL.
  • You need Shopify admin access to the active theme.

Step-by-step check in Shopify admin

1. Open the active theme’s code

  1. Log in to your Shopify admin.
  2. Go to Online Store and select Themes.
  3. Next to the active theme, click the three dots icon and choose Edit code.
  4. Open the Layout folder and select theme.liquid.

2. Look for the SeaText snippet

Search the file for the SeaText code or a distinctive part of the snippet. You can use your editor’s search tool. If the snippet is present and the file was saved, the main script is installed.

3. Add the code if it is missing

Return to the SeaText integration page, copy the JavaScript code, and paste it in the spot described in the instructions. Then click Save to preserve your changes.

Common mistake: people paste the snippet into a different template because the left sidebar lists many files. The main script goes in Layout > theme.liquid.

4. Check the dashboard

Go back to the SeaText dashboard. Look for the green Connected indicator for your store’s domain. If it is present, the core connection is working.

Browser check: is the script actually loading?

Storefront visits reveal whether the script is active on the page your customers see.

  1. Open your storefront in a normal browser window.
  2. Right-click anywhere on the page and choose View Page Source or Inspect.
  3. Search the source for the SeaText code or the snippet’s unique string.
  4. If you use the Network panel, reload the page and look for a request to SeaText’s script domain.

If the request appears, the script is loading. If it does not, the code is either not in the active theme or the page is cached. Try a hard reload or a private window.

Check the product description tag

The main script is only part of the setup for product copy features. The instructions also ask you to wrap the product description output and verify that the data- attribute is present in the HTML source.

  1. Open a product page in your Shopify store.
  2. Right-click the product description and choose Inspect.
  3. Look for the element that contains the description.
  4. Confirm the required data- attribute is shown in the HTML.

Use the browser’s developer tools for this. You do not need to guess by looking at the rendered page.

Confirm data syncing in the dashboard

After you load a storefront page, return to the SeaText dashboard. If the connection is correct, the dashboard should recognize the traffic and associate it with your account. If the Connected status stays missing, recheck the code and the domain.

Key SeaText Shopify connection facts

FactWhat it means for your check
You need a SEATEXT AI account before installing.Create the account first, then check the code.
The AI remains inert until activated.Connected is not the same as active.
Each account is linked to one primary URL.Check that your store domain matches the account.
One account per domain.Use separate accounts for dev and production domains.
Development URLs such as localhost are restricted.Test on a real, valid domain.
The script belongs in Layout > theme.liquid.Search that file, not a random template.
Click Save after pasting.Unsaved code still means no connection.

Terms you may see

  • Primary URL: the domain that a SeaText account is linked to.
  • Inert: installed but not performing AI actions until activated.
  • data- attribute: a custom HTML attribute used by the product description tag.
  • Dynamic development domain: a temporary or preview URL that changes, which may not work reliably.

When the connection check fails

Work through the list in order.

  • Code is in the wrong file. Open Layout > theme.liquid and search again.
  • The wrong theme is active. You must edit the current live theme.
  • The file was not saved. Paste the code, then click Save.
  • The domain does not match the account. Create a separate SeaText account for each primary URL.
  • You are testing on localhost or a dynamic development domain. These are restricted for security reasons. Use a real domain.
  • The browser is serving a cached page. Hard reload or open a private window before inspecting.

Limitations and when this check does not apply

This check works for stores that use the standard Shopify theme structure with theme.liquid. It also assumes you use a real, valid domain.

If you use SeaText AI on multiple websites, create one account per website. Each account is linked to a single primary URL. If you skip that, traffic can be associated with the wrong account.

Do not test with localhost. Dynamic development domains may also fail because SeaText AI might not be able to reliably associate traffic with your account.

Finally, remember that a passed connection check is not an activation check. The AI stays inert until you activate the agents you need.

Frequently asked questions

Why does my dashboard still not show Connected after I pasted the code?

Check that you saved theme.liquid, that you edited the active theme, and that your store’s domain matches the SeaText account.

What is the difference between connected and active?

Connected means the script is installed and can work. Active means an agent is switched on. The AI remains inert until activated.

Can I check the connection on localhost?

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

Can one SeaText account work on multiple Shopify stores?

No. Create one account per website, because each account is linked to a single primary URL.

Do I need to add the product tag to every template file?

No. The main script goes in theme.liquid. The product description tag goes around the product description output, typically in product.liquid or product-template.liquid.

Will customers see the data- attribute?

No. The data- attribute appears in the HTML source, not as visible text on the product page.

Ready to confirm your setup with the official instructions? Open the Shopify integration guide.

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

The Shopify Integration page provides the JavaScript snippet and the step-by-step theme setup. It also states the requirements that affect your check: you need a SEATEXT AI account, one account per domain, and no localhost or dynamic development domains. Use that page to copy the current code and confirm the exact placement before you test the connection.