Seatext library

When Should I Contact SeaText AI Support for Connection Issues?

Contact SeaText AI support after you have run the basic setup checks, if the connection error persists for more than 30 minutes, or if you see an unusual error about your account or domain....

Contact SeaText AI support when a connection problem survives basic troubleshooting, lasts longer than 30 minutes, or throws an unusual error you cannot explain. If the issue is a simple setup mistake, you can usually fix it yourself from the integration guide. This article gives you a clear decision framework so you know exactly when to escalate and what to include in your support message.

When to Contact Support: The Decision Trigger

Use these three criteria. If any one of them is true, it is time to contact support:

  • You have already run the readiness checklist below and the connection still fails.
  • The problem has continued for more than 30 minutes with no change.
  • You see an unusual error message, such as an account-domain mismatch, an authorization warning, or a security restriction you have never seen before.

If the error mentions your account email, primary URL, or a blocked domain, do not wait for the 30-minute mark. Those are account-level issues and usually need a human to check them.

Before You Contact Support: Readiness Checklist

Most SeaText AI connection issues come from setup details, not from an outage. Run this checklist first:

  • You have a SEATEXT AI account for the exact domain. Each account is linked to a single primary URL.
  • You copied the JavaScript code from your SEATEXT AI account, not from a third party.
  • You pasted that code into the correct theme file. For Shopify, that is theme.liquid inside the Layout folder.
  • You clicked Save after pasting the snippet.
  • You are testing on a valid, real domain, not localhost.
  • You are not using a dynamic development domain that SeaText AI cannot reliably associate with your account.
  • If you use SeaText AI on multiple websites, you have a separate account for each website.
  • Your page still loads correctly with the snippet installed.

If any item is missing, fix it and test again before contacting support. That one step will save you from an unnecessary support ticket.

Signs to Wait (and What to Do While Waiting)

Not every connection issue needs immediate support. Wait when you see one of these situations:

  • The error appeared right after you edited your theme. Re-check the file and make sure you saved it.
  • The error disappears when you reload the page. That often means a temporary loading hiccup, not a permanent failure.
  • You have not verified that the data- attribute is present in your HTML source. Use your browser's developer tools to inspect the page.
  • The problem only happens on a development URL. Development URLs are restricted, so you need a real domain for testing.

While you wait, collect useful details: the exact error message, the domain, the account email, and the time the problem started. This prepares you for a faster resolution if you do need support.

Why 30 Minutes is a Good Default

Most temporary connection errors, such as a slow script load or a brief server hiccup, resolve within 30 minutes. That is short enough to avoid wasting your time and long enough to weed out transient problems. If you have not changed anything and the issue still exists after that window, escalation is reasonable.

The Exception: When Not to Wait

Do not wait 30 minutes if you see an error that mentions:

  • Account not found or account mismatch
  • Primary URL mismatch
  • Security restriction or blocked domain
  • Multiple accounts or multiple domains conflict

These are account-level signals. Contact support after confirming the basics, because they are unlikely to fix themselves. Also, if the snippet is visibly breaking your site, remove it immediately, restore your file, and then contact support.

How SeaText AI Connections Work

SeaText AI connects to your website through a JavaScript snippet. You copy the code from your SEATEXT AI account and paste it into your theme. The installation process is secure, and the AI remains inert until you activate it. That means the snippet alone will not change your content or move data until you turn on the agents you want.

Each account is linked to a single primary URL. This is a deliberate restriction. If you need SeaText AI on a development domain and a production domain, you must create separate accounts. Using one account on multiple websites can cause connection errors because SeaText AI cannot reliably tell which domain the traffic belongs to.

This is why many connection problems trace back to domain setup, not to the AI service itself.

What Happens if You Ignore a Connection Problem

Ignoring a persistent problem means your agents never run, so you miss the conversion uplift, ad optimization, or translation work you planned. Worse, the real cause may be a domain mismatch. That will keep producing confusing errors on every page until you fix the account setup.

Handling it early also keeps your site healthy. A missing or broken snippet can slow down pages or stop agents from firing, which hurts your results and makes it harder to know what is actually working.

Common Connection Problems and How to Check Them

ProblemLikely causeCheck this
Script does not load on product pagesSnippet missing from the product templateWrap the product description output in the data- attribute and test again
Works on live site but not on test sitelocalhost or dynamic development domainUse a valid, real domain
Error says account or domain not recognizedAccount linked to a different primary URLConfirm the domain matches the account
Two websites are using one accountOne account cannot cover multiple primary URLsCreate a separate account for each website
Changes did not saveForgot to click Save after pastingClick Save and re-test

Step-by-Step: Use This Decision Framework

  1. Capture the exact error message almost word for word.
  2. Run the readiness checklist above.
  3. If a checklist item is wrong, fix it and test again.
  4. If the checklist passes, note the time and wait up to 30 minutes.
  5. If the error persists or is unusual, contact SeaText AI support with the error message, domain, account email, and the steps you already tried.

This order prevents you from sending a vague ticket like 'it does not work' and helps support find the cause on the first try.

Key Facts About SeaText AI Connections

FactDetail
InstallationCopy the JavaScript code from SEATEXT AI and paste it into your theme file.
SecurityThe installation process is secure, and the AI remains inert until activated.
Account requiredYou need a SEATEXT AI account before you can install the script.
Primary URLEach SEATEXT AI account is linked to a single primary URL.
Multiple domainsSeparate accounts are needed for each domain.
LocalhostDevelopment URLs such as localhost are restricted for security reasons.
Dynamic dev domainsThey may not function because SeaText AI might not reliably associate traffic with your account.

Limitations and When This Advice Does Not Apply

This article focuses on connection issues covered by the SeaText AI integration guide. It does not cover billing, refunds, or contract questions. For those, start with the pricing page.

If your problem is caused by a site-wide network outage, a browser extension, or a host-level firewall, SeaText AI support will not be able to fix it from their side. You would need to check those systems first.

If your site is not on Shopify, the file names will be different, but the same principles apply: use a real domain, use one account per domain, and verify the snippet is saved.

If you are not sure whether the issue is from SeaText AI or from your hosting provider, run the readiness checklist first. That will tell you which side to investigate.

Frequently Asked Questions

How long should I wait before contacting SeaText AI support?

After the basic checklist passes, wait up to 30 minutes if the error is not unusual. If the error mentions your account or primary URL, contact support sooner.

What should I include in a support message?

Send the exact error text, your domain, the account email you used, and a list of the steps you already tried. Also mention whether the problem happens on a live or development domain.

Can I test SeaText AI on localhost?

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

Why do I need a separate account for each domain?

Each SEATEXT AI account is linked to a single primary URL. If you want SeaText AI on multiple domains, you must create separate accounts for each.

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

It means the JavaScript snippet installs safely, but it does not start changing your site or sending data until you activate the agent you want to use.

What should I do if the snippet breaks my page?

Remove the snippet, restore the original file, and save. Then contact support with a description of what broke and what you saw before.

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 can help you verify the most common connection causes before you escalate. The Shopify integration guide shows where to paste the JavaScript snippet, reminds you to save your changes, and explains that each account is tied to a single primary URL. One important requirement: you need a separate account for each domain, and localhost is restricted. Start with the integration guide to confirm your setup, then contact support if the problem continues.