How to Test SeaText on a Squarespace Preview Domain
To test SeaText on a Squarespace preview domain, you must install the JavaScript snippet into the Code Injection header of your Squarespace site and verify the connection. Because preview domains are separate from your...
Testing SeaText on a Squarespace preview domain requires a specific setup because preview domains are considered separate from your live production domain. To test the integration, you must install the SeaText JavaScript snippet into your Squarespace preview site's code injection settings and activate the AI connection. Since each domain requires its own SeaText account, you will need to set up a dedicated account for your preview environment. This guide walks you through the exact steps to get your preview domain running with SeaText.
Understanding Squarespace Preview Domains and SeaText
A Squarespace preview domain is a temporary, private URL that allows you to view your website changes before publishing them live. This is extremely useful when you are configuring SeaText, as it lets you test AI translations, copy optimizations, and personalization rules without exposing them to your live visitors. However, because the preview domain is distinct from your primary domain, SeaText treats it as a separate website. This separation is crucial because it prevents testing configurations from interfering with your live site's performance and data.
Prerequisites for Testing SeaText on Preview
Before you begin the installation, you need to meet a few requirements. First, you must have a dedicated SeaText account for the preview domain. SeaText accounts are linked to a single primary URL, so your live site and preview site cannot share the same account. This policy ensures that traffic data and AI configurations remain isolated between environments. Second, you need access to your Squarespace dashboard where you can manage code injection. Finally, you need the SeaText JavaScript snippet, which you can copy from your SeaText dashboard after creating the account.
Step-by-Step Installation of SeaText on Squarespace Preview
Follow these steps carefully to install the SeaText script on your Squarespace preview domain:
- Create a Dedicated SeaText Account: Go to the SeaText signup page and create an account specifically for your preview domain. Once logged in, copy the unique JavaScript code snippet provided in the integration section.
- Access Squarespace Settings: Log in to your Squarespace dashboard, navigate to the website panel, click the three dots icon next to your site, and select "Settings".
- Navigate to Developer Tools: Scroll to the very bottom of the settings menu on the left and click on "Developer Tools". This section is designed for advanced website customization.
- Open Code Injection: Click on the "Code Injection" tab. This is where you can insert custom code snippets that apply globally to your site.
- Paste the SeaText Code: Paste your SeaText JavaScript snippet into the designated HEADER area. The header is the correct location because it ensures the script loads before any other page elements, allowing SeaText to initialize properly.
- Save and Publish: Click "Save" to preserve your changes. Ensure that your website is published on the preview domain to apply the changes to the live preview environment.
Activating and Verifying the SeaText AI Connection
After installing the code, you must activate the AI connection to ensure SeaText is tracking correctly. Start by visiting or refreshing your preview website several times. As you browse, stay on the page for at least 40 seconds. This duration is necessary for the AI to initialize and link the traffic to your specific SeaText account. After completing these visits, wait at least five minutes. You should then see your website name displayed next to the SeaText logo at the top of your SeaText dashboard. This visual confirmation indicates that your preview domain is successfully connected and ready for configuration. If the website name does not appear after 10 minutes, contact the SeaText support team immediately, as this could indicate an installation issue that needs troubleshooting.
Key Facts: SeaText on Squarespace Preview Domains
The following table summarizes the essential facts about using SeaText on a Squarespace preview domain, based on official integration guidelines:
| Fact | Detail |
|---|---|
| Separate Account Required | You must create a separate SeaText account for each domain, including preview and development domains. |
| Code Placement | The JavaScript snippet must be pasted into the HEADER area of the Code Injection panel in Squarespace. |
| Activation Visit | You must visit the preview site and stay on the page for at least 40 seconds to activate the AI tracking. |
| Verification Indicator | Wait 5 minutes after activation visits; the website name should appear next to the SeaText logo. |
| Restricted URLs | Localhost and dynamic development domains are restricted for security reasons and will not function. |
Limitations and Important Restrictions
When testing SeaText on a Squarespace preview domain, be aware of certain limitations that can affect the integration. Development URLs, such as localhost, are strictly restricted for security reasons. SeaText requires a valid, real domain to function properly and associate traffic with your account. Additionally, dynamic development domains—those that change frequently or use temporary subdomains—may not function properly because SeaText cannot reliably associate the traffic with your account. Always use a stable, real domain for testing to ensure the AI initializes correctly and data is accurately tracked. If you are working in a local development environment, you will need to push your changes to a staging server with a real domain name before SeaText can be tested.
Frequently Asked Questions
Can I use the same SeaText account for my live site and preview domain?
No. Each SeaText account is linked to a single primary URL. To use SeaText on multiple domains, including a preview domain, you must create separate accounts for each. This isolation prevents testing configurations from affecting your live site's data and performance.
How long does it take for SeaText to recognize my preview domain?
After installing the code, visit the site and stay on the page for at least 40 seconds. Then, wait at least five minutes for your website name to appear next to the SeaText logo. If it does not appear within 10 minutes, you should contact SeaText support to investigate potential installation issues.
Why won't SeaText work on localhost or local development environments?
Localhost URLs are restricted for security reasons. SeaText requires a valid, real domain to function properly and securely associate traffic with your account. This restriction prevents unauthorized access and ensures that only legitimate domains are linked to your account.
What should I do if the website name does not appear in SeaText after 10 minutes?
If the website name does not appear next to the SeaText logo after 10 minutes, contact the support team immediately. This could indicate an issue during the installation on your platform, such as incorrect code placement or a caching problem, and you may need assistance to resolve it.
Can I test SeaText features on a preview domain before going live?
Yes, testing on a preview domain is the recommended way to configure SeaText before deploying it on your live site. By using a separate account for your preview domain, you can safely test AI translations, copy optimizations, and personalization rules without affecting your live visitors or data.
How does SeaText handle privacy on a private preview link?
SeaText operates independently of Squarespace's privacy settings on preview links. As long as the JavaScript snippet is installed on the preview domain, SeaText will track visits to that domain. The AI remains inert until activated, ensuring your website's content integrity is maintained during testing.
Further reading and comparison sources
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
Learn more
Visit the website for more information.