Debug logging for third-party scripts
This is an experimental feature.
The
enableScriptsLogs flag helps you troubleshoot third-party scripts and analytics behavior in FastStore by adding debug logs to the browser console.Use this feature when you need more visibility into script execution and event payloads during development or staging validation.
Before you begin
We recommend enabling this flag only in development or staging environments. This feature increases browser console output and may make debugging noisier if left enabled all the time.
Step 1: Update FastStore packages
Update the FastStore packages to the latest version:
_10yarn upgrade -L --scope @faststore
Step 2: Enable enableScriptsLogs
- Open your
discovery.config.jsfile. - In the
experimentalobject, setenableScriptsLogstotrue.
Step 3: Validate logs in the browser
- Open your store in a development or staging environment.
- Open browser Developer Tools and go to the Console tab.
- Filter logs by
vtexto quickly locate FastStore script logs. - Navigate through key storefront flows, such as:
- Search for a product and open a product page.
- Trigger actions that send analytics events.
- Validate GTM events during debugging sessions.
- Confirm logs are being emitted with expected payload structure.
With this flag enabled, you should see logs related to:
- Partytown debug and forwarded calls.
- Google Tag Manager (GTM)
dataLayer.pushevents. - VTEX Request Capture (
sendrc) and Activity Flow calls. - Intelligent Search Events payloads.