Skip to content

Update Google Analytics configuration summary #1263

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
addisonschultz merged 1 commit into from
Aug 7, 2026
Merged

Update Google Analytics configuration summary #1263

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/tired-berries-sleep.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
'@gitbook/integration-googleanalytics': patch
---

Update summary to better configure integration
21 changes: 20 additions & 1 deletion integrations/googleanalytics/gitbook-manifest.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,26 @@ summary: |

# Configure

GitBook admins can enable the Google Analytics integration by navigating to organization settings. The integration can be enabled on single or multiple spaces available publicly.
Configure the integration for each site you want to track. You can add your measurement ID from the sidebar or from site settings.

This covers GA4 properties, which use a measurement ID in the format G-XXXXXXXXXX. If you're still using a Universal Analytics property (UA-XXXXXXXXX-Y), upgrade to GA4 first — Google sunset Universal Analytics in 2024.

**Add the measurement ID from the sidebar**

1. Open the Integrations tab in the sidebar.
2. Find Google Analytics in the list of installed integrations and click Configuration.
3. Click Pick a site and select the site you want to track.
4. Open the Actions menu next to the site name and click Configure in site.
5. Add your measurement ID (G-XXXXXXXXXX) in the Measurement ID field.

**Add the measurement ID from site settings**

1. Open the site you want to track.
2. Click Integrations in the top right.
3. Find Google Analytics and click the settings icon.
4. Add your measurement ID (G-XXXXXXXXXX) in the Measurement ID field.

Your site will start sending data to Google Analytics. Data can take up to 48 hours to appear in your dashboard.
categories:
- analytics
configurations:
Expand Down
Loading