Configure Squarespace in GermainUX
Deploy GermainUX RUM JS
Troubleshooting
Deployment and configuration
Select the required deployment
Deployment workflow
Requirements
Before starting, confirm the following:Configure Squarespace in GermainUX
In GermainUX:- Go to Workspace > Settings > Wizards.
- Select Squarespace.

- Enter the required configuration.
Deploy GermainUX RUM JS
Site-wide code injection
Use site-wide code injection when all supported Squarespace pages must be monitored.- Sign in to Squarespace as an authorized administrator.
- Open the website to monitor.
- Open the website’s settings.
- Locate Code Injection under the applicable advanced, developer, or website-tools settings.

- Paste the RUM JS snippet generated by GermainUX into the Header section.
- Save the configuration.
- Open the published website and validate the deployment.
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.
Google Tag Manager
When Google Tag Manager is already authorized for the site, RUM JS can be deployed using Google Tag Manager.Create a Custom HTML tag containing the GermainUX RUM JS snippet
Configure it to run on the required Squarespace pages
Coordinate its trigger with consent requirements
Preview and validate the tag
Publish the container
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
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
Consent management
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
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
Show all 10
Show all 10
- Sensitive form fields
- URL parameters containing identifiers
- Protected or confidential content
- Pages containing regulated information
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
Show all 12
Show all 12
- Scheduling and booking pages
- Donation pages
- Product and category pages
- Cart
- Customer-controlled checkout pages
- Confirmation and success pages
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
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
Show all 13
Show all 13
- Quantity update
- Cart view
- Checkout start
- Payment result visible to the browser
- Order confirmation
- Cart abandonment
- Checkout abandonment
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
Configure business processes
Model critical Squarespace journeys as GermainUX business processes.- Started and completed journeys
- Completion and conversion rate
- Funnel drop-off
- End-to-end duration
- Time spent at each stage
- Repeated or unnecessary actions
Show all 9
Show all 9
- 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
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
- 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
Show all 11
Show all 11
- Form destinations
- Commerce and payment integrations
- Scheduling services
- CRM and marketing platforms
- Customer-defined services
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
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
Show all 12
Show all 12
- 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
- Execution frequency
- Execution location
- Test credentials
- Validation steps
- Timeouts
- Alerts
Show all 9
Show all 9
- Evidence collection
- Maintenance windows
- Test-data cleanup
Validate the deployment
Save the Squarespace code-injection configuration
Open the published website in a supported browser
Confirm that the GermainUX RUM JS resource loads successfully
Confirm that monitoring requests reach the GermainUX environment
Navigate through representative pages
Exercise the configured forms, membership, booking, donation, or commerce journeys
Verify that sessions, pages, clicks, events, errors, and performance data appear in GermainUX
Open a Session Replay and confirm that it reconstructs the interaction correctly
Verify that sensitive information is masked or excluded
Test accepted, rejected, and withdrawn consent
Validate desktop, tablet, and mobile layouts
Confirm that RUM JS loads only once per page
Test API monitoring, synthetic transactions, and alerts when enabled
Troubleshooting
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.
Show all 13
Show all 13
- 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.
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
Can't find what you need?
The content of this document is proprietary to GERMAIN SOFTWARE.


