Skip to main content

Configure Squarespace in GermainUX

Set up Squarespace integration

Deploy GermainUX RUM JS

Add script to Squarespace

Troubleshooting

Get Squarespace help

Deployment and configuration

Finish Squarespace setup
Deploy Monitoring for Squarespace Deploy GermainUX monitoring on Squarespace to capture Real User Monitoring, Session Replay, performance, browser errors, forms, customer journeys, conversion, and third-party service activity. GermainUX can also monitor customer-accessible APIs and integrations and execute synthetic website, form, booking, membership, and commerce scenarios. For a complete description of the available capabilities, see Squarespace Monitoring.

Select the required deployment

Deployment workflow

Requirements

Before starting, confirm the following:

Configure Squarespace in GermainUX

In GermainUX:
  1. Go to Workspace > Settings > Wizards.
  2. Select Squarespace.
    Deploy Monitoring for SquareSpace: Configure Squarespace in GermainUX
  3. Enter the required configuration.
Complete the wizard and copy the generated GermainUX RUM JS snippet. If a Squarespace-specific wizard is unavailable in the installed GermainUX version, create the application and UX monitoring profile manually and use the RUM JS installation snippet generated for that profile.

Deploy GermainUX RUM JS

Site-wide code injection

Use site-wide code injection when all supported Squarespace pages must be monitored.
  1. Sign in to Squarespace as an authorized administrator.
  2. Open the website to monitor.
  3. Open the website’s settings.
  4. Locate Code Injection under the applicable advanced, developer, or website-tools settings.
    Deploy Monitoring for SquareSpace: Site-wide code injection
  5. Paste the RUM JS snippet generated by GermainUX into the Header section.
  6. Save the configuration.
  7. Open the published website and validate the deployment.
Squarespace navigation labels can vary by platform and interface version. Use the current Code Injection settings provided for the website. Adding RUM JS to the header enables monitoring to start early enough to capture the initial page load, browser activity, errors, and user interactions. Do not use a generic example URL in production. Use the snippet generated for the correct GermainUX environment, application, and UX monitoring profile.

Selected-page deployment

If monitoring must be restricted to selected pages, use an approved page-level code block or page-header configuration where Squarespace permits it. Confirm that:
  • The code executes in the required page context.
  • It loads before the interactions that must be monitored.
  • It is added to every page included in the monitoring scope.
  • It does not appear visibly as page content.
  • It is not also injected through the site-wide header.
Site-wide and page-level deployment must not load the same RUM JS configuration twice.

Google Tag Manager

When Google Tag Manager is already authorized for the site, RUM JS can be deployed using Google Tag Manager.
1

Create a Custom HTML tag containing the GermainUX RUM JS snippet

2

Configure it to run on the required Squarespace pages

3

Coordinate its trigger with consent requirements

4

Preview and validate the tag

5

Publish the container

Ensure that RUM JS is deployed through only one method.

Configure the monitored domains

Add every authorized production and test domain to the GermainUX UX monitoring profile, including applicable:
  • Squarespace-provided domains
  • Custom primary domains
  • Regional domains
  • Subdomains
  • Testing or staging domains
Do not allow unrestricted domains. Remove temporary or obsolete domains after testing is complete.

Content Security Policy

If the website uses a Content Security Policy or another security control, authorize only the GermainUX origins required to:
  • Download RUM JS
  • Send monitoring data to GermainUX
  • Load enabled feedback or supporting resources
Use HTTPS and the most restrictive directives supported by the deployment. Do not authorize unrelated domains or broad wildcards. Coordinate GermainUX startup with Squarespace’s cookie controls or the website’s consent-management platform. Depending on the applicable requirements, configure RUM JS to:
  • Start only after the required consent is granted
  • Avoid starting when the visitor rejects the applicable consent category
  • Respect consent withdrawal
  • Apply the correct behavior by geography
  • Preserve the selected consent state across page navigation
  • Avoid creating visitor identifiers before authorization
Test monitoring with consent accepted, rejected, and withdrawn.

Privacy and Session Replay

Configure compliance, privacy, and security controls before enabling production Session Replay. Mask or exclude:
  • Passwords
  • Authentication and session tokens
  • Payment information
  • Names and contact details
  • Billing and shipping addresses
  • Account and membership information
  • Sensitive form fields
  • URL parameters containing identifiers
  • Protected or confidential content
  • Pages containing regulated information
Configure appropriate retention periods and role-based access to session and replay data. Test privacy rules across desktop, tablet, and mobile layouts.

Configure monitored pages

Deploy RUM JS on supported customer-controlled pages involved in important journeys, including:
  • Home and landing pages
  • Content and service pages
  • Blog pages
  • Form pages
  • Registration and login
  • Membership pages
  • Scheduling and booking pages
  • Donation pages
  • Product and category pages
  • Cart
  • Customer-controlled checkout pages
  • Confirmation and success pages
Squarespace may prevent injected code from executing on certain platform-managed pages, checkout steps, payment interfaces, account screens, or third-party browser contexts. Each required page or browser context must independently permit GermainUX code.

Configure forms

Configure the events required for lead-generation and form analysis:
  • Form displayed
  • Form started
  • Validation displayed
  • Submission attempted
  • Browser-visible success
  • Browser-visible failure
  • Form abandoned
  • Confirmation displayed
Do not collect unrestricted form values. Capture only the approved attributes required for analysis. A success message indicates what the visitor saw. To confirm that a submission was received and processed, correlate it with an accessible API, webhook, CRM, email platform, or other destination system.

Configure commerce events

For Squarespace Commerce, configure applicable customer events using two mechanism: “phase of interest” and “custom replay insight” or such as:
  • Product search
  • Category view
  • Product view
  • Product-option selection
  • Add to cart
  • Remove from cart
  • Quantity update
  • Cart view
  • Checkout start
  • Payment result visible to the browser
  • Order confirmation
  • Cart abandonment
  • Checkout abandonment
Browser activity should not be treated as the authoritative source for completed orders, payments, fulfillment, inventory, or refunds. When server-confirmed commerce information is required, correlate the browser journey with accessible Squarespace APIs, webhooks, payment-provider information, or another approved source.

Configure subscriptions, bookings, and donations

Depending on the Squarespace capabilities used by the website, configure observable stages for:
  • Newsletter subscriptions
  • Member registration
  • Account login
  • Appointment scheduling
  • Class or event booking
  • Donation initiation
  • Payment
  • Browser-visible confirmation
For a journey involving an external platform, monitor the transition into and return from that service and correlate it with available APIs, webhooks, or destination records.

Configure business processes

Model critical Squarespace journeys as GermainUX business processes. GermainUX can then analyze:
  • Started and completed journeys
  • Completion and conversion rate
  • Funnel drop-off
  • End-to-end duration
  • Time spent at each stage
  • Repeated or unnecessary actions
  • Errors and performance delays
  • Visitors and segments affected
  • Potential lead or revenue impact

Configure campaign attributes

Capture approved campaign and referral attributes required for marketing analysis, such as:
  • Campaign
  • Source
  • Medium
  • Referrer
  • Landing page
  • Promotion
  • Customer-defined audience segment
Exclude sensitive or unrestricted query parameters. Preserve only the attributes required for attribution and segmentation.

Third-party and platform-managed contexts

A Squarespace journey may involve:
  • A Squarespace-managed page that does not execute customer code
  • An external payment provider
  • A scheduling service
  • An authentication provider
  • A cross-origin iframe
  • An embedded third-party application
GermainUX cannot directly inspect the internal activity of these contexts unless its monitoring code is authorized to execute there. Where direct monitoring is unavailable, configure alternative evidence such as:
  • Navigation into and return from the external context
  • Redirect duration
  • Browser-visible success or failure
  • Order, booking, donation, or subscription status
  • API or webhook responses
  • Integration logs
  • Synthetic transaction results

Deploy API and integration monitoring

Deploy a GermainUX Engine when monitoring must extend to customer-accessible APIs, webhooks, and connected services. Depending on the interfaces and permissions available, configure:
  • Endpoint availability
  • Response time
  • HTTP status
  • Authentication failures
  • Response validation
  • Webhook delivery
  • Form destinations
  • Commerce and payment integrations
  • Scheduling services
  • CRM and marketing platforms
  • Customer-defined services
Squarespace manages the underlying hosting platform. GermainUX cannot directly monitor Squarespace servers, databases, internal logs, or platform services that Squarespace does not expose.

Deploy the JS Profiler

Deploy the GermainUX JS Profiler on selected administrator, QA, development, or support browsers for deeper analysis of:
  • JavaScript exceptions
  • Browser console events
  • Slow or failed network requests
  • Custom JavaScript
  • Third-party scripts and tags
  • Browser freezes
  • Long-running JavaScript
  • Client-side performance bottlenecks
The JS Profiler is generally deployed to selected diagnostic browsers rather than every public visitor’s browser.

Deploy synthetic monitoring

Use the GermainUX RPA Bot Recorder to record representative scenarios, such as:
  • Open the website
  • Navigate to a critical page
  • Search for content or products
  • Submit a controlled test form
  • Subscribe to a newsletter
  • Register or sign in
  • Book a service
  • Initiate a donation
  • Add a product to the cart
  • Begin checkout
  • Complete an approved test transaction
  • Confirm that the expected result appears
Deploy the scenario through a GermainUX Engine and configure:
  • Execution frequency
  • Execution location
  • Test credentials
  • Validation steps
  • Timeouts
  • Alerts
  • Evidence collection
  • Maintenance windows
  • Test-data cleanup
Production scenarios must use controlled accounts, forms, products, payment methods, and cleanup procedures. Do not create unintended leads, charges, donations, bookings, subscriptions, or orders.

Validate the deployment

1

Save the Squarespace code-injection configuration

2

Open the published website in a supported browser

3

Confirm that the GermainUX RUM JS resource loads successfully

4

Confirm that monitoring requests reach the GermainUX environment

5

Navigate through representative pages

6

Exercise the configured forms, membership, booking, donation, or commerce journeys

7

Verify that sessions, pages, clicks, events, errors, and performance data appear in GermainUX

8

Open a Session Replay and confirm that it reconstructs the interaction correctly

9

Verify that sensitive information is masked or excluded

10

Test accepted, rejected, and withdrawn consent

11

Validate desktop, tablet, and mobile layouts

12

Confirm that RUM JS loads only once per page

13

Test API monitoring, synthetic transactions, and alerts when enabled

Troubleshooting

For additional assistance, contact GermainUX Support.

Deployment and configuration

  • Review Squarespace Monitoring.
  • Confirm that the Squarespace plan and website configuration support code injection.
  • Create the Squarespace application and UX monitoring profile in GermainUX.
  • Deploy GermainUX RUM JS through Squarespace header code injection.
  • Use Google Tag Manager deployment when tag management is the selected deployment method.
  • Configure consent, masking, anonymization, exclusions, retention, and bot filtering.
  • Configure navigation, form, subscription, registration, booking, donation, product, cart, checkout, and confirmation events as applicable.
  • Configure business processes, conversion funnels, drop-offs, segmentation, campaign attribution, and business-impact measures.
  • Deploy the GermainUX JS Profiler for deeper browser and JavaScript diagnostics.
  • Deploy the GermainUX Engine for synthetic monitoring, customer-accessible APIs, webhooks, integrations, and automation.
  • Deploy the GermainUX RPA Bot Recorder to create synthetic Squarespace scenarios.
  • Configure automated analytics, outlier detection, KPIs, SLAs, dashboards, alerts, and approved automated actions.
  • Define maintenance windows for planned publications, campaigns, domain changes, and integration updates.
Component requirements and monitoring coverage depend on the Squarespace plan, website architecture, supported page types, code-injection availability, consent configuration, third-party ownership, accessible APIs, and desired monitoring depth.

Get More Information

GermainUX can help determine which monitoring, analytics and automation capabilities are appropriate for your SquareSpace eCommerce environment. Contact GermainUX Support.

Get Help

Contact GermainUX Support

The GermainUX team helps you get up and running faster, empower your team, turn data into actionable insights, and optimize performance to deliver measurable business outcomes.

Can't find what you need?

Search all GermainUX docs with Ctrl + K, or use the feedback buttons at the bottom of this page to tell us what is missing.

The content of this document is proprietary to GERMAIN SOFTWARE.