The Google Analytics 4 (GA4) Integration feature allows you, as a portal admin, to connect your own GA4 property to your portal so that you can track visitor behaviour and performance directly within your Google Analytics dashboard. This integration works by storing your GA4 Measurement ID against your portal configuration and injecting the Google Analytics tracking script into your site's frontend when you publish.
This article covers the following topics:
2. How to configure and manage your Analytics
2.1 Navigating to the Analytics Configuration Page
2.2 Entering Your GA4 Measurement ID
2.2.1 Measurement ID Format Rules
2.3 Saving Your Measurement ID
2.3.1 What Happens on a Successful Save
2.4 Publishing for Tracking to Begin
2.5 Updating or Removing Your Measurement ID
2.5.2 Removing the Integration
1. Pre-Requisites
Before you can configure GA4 for your portal, make sure the following areas are in place. Skipping any of these will prevent the integration from working as expected.
| Area | Why It Matters |
| Google Analytics 4 Account & Property | You must have an active GA4 property set up in your Google account. The portal does not create or validate this for you — it only stores the ID you provide. |
| GA4 Measurement ID | Your Measurement ID is generated inside your GA4 property. Without it, there is nothing to enter into the integration field. |
| Portal (Active Status) | The Analytics configuration page is only accessible when your portal is in an active state. Portals with a status of Delete Pending or Deleted cannot access this page. |
2. How to configure and manage your Analytics
2.1 Navigating to the Analytics Configuration Page
- Click Settings on the top menu bar
- Click Analytics on the left menu bar
2.2 Entering Your GA4 Measurement ID
The core of this page is a single text field labelled Analytics. This is where you enter your GA4 Measurement ID — the unique identifier that tells Google Analytics which property to send your portal's data to.
| Element | Detail |
| Field type | Single-line text input |
| Placeholder text | e.g. G-1A2B3C4D5E |
| Helper text | Find this ID in your GA4 property under Admin → Data Streams → Web → Measurement ID |
The placeholder and helper text are there to guide you in case you are unsure where to find your Measurement ID in Google Analytics. If you have not located your Measurement ID yet, follow the path described in the helper text before proceeding.
2.2.1 Measurement ID Format Rules
The portal enforces specific formatting rules on the Measurement ID you enter. These rules exist to reduce the risk of invalid IDs being saved, which would result in your analytics not tracking at all. The field will handle some formatting issues automatically, but others will block you from saving.
| Rule | Detail |
| Required prefix | Must begin with G- |
| Remaining characters | Alphanumeric only |
| Maximum length | 20 characters total |
| Spaces | Not allowed |
| Case sensitivity | Input is case insensitive — you can type in upper or lower case |
| Whitespace trimming | Leading and trailing whitespace is removed automatically |
A valid Measurement ID looks like this:
G-1A2B3C4D5E
If the ID you enter does not match these rules, the Save button will remain disabled and an inline error message will display: "Invalid Google Analytics ID format". Double-check your ID in your GA4 account if you see this error.
2.3 Saving Your Measurement ID
Once you have entered a valid Measurement ID, the Save button becomes active. Understanding what happens — and what does not happen — when you click Save is important, saving and going live are two separate steps.
2.3.1 What Happens on a Successful Save
When you enter a valid ID and click Save:
- The Measurement ID is stored against your portal's configuration.
- A success message appears: "Update saved – publish your site for changes to take effect."
- The Save button becomes disabled again until you make further changes to the field.
2.4 Publishing for Tracking to Begin
Publishing your portal is the step that makes your GA4 integration live.
When you publish your portal after saving a valid Measurement ID, the portal injects the Google Analytics script into the <head> of your site's frontend. This applies to whichever environment you publish to:
- Staging environment — if you publish to staging, the script is injected there.
- Production environment — if you publish to production, the script is injected there.
Once the script is live, Google Analytics will begin collecting visitor data and sending it to your GA4 property.
2.5 Updating or Removing Your Measurement ID
You can return to the Analytics page and make changes to your Measurement ID at any time. The process is the same regardless of whether you are adding an ID for the first time, replacing an existing one, or removing it entirely.
2.5.1 Updating an Existing ID
If you need to switch to a different GA4 property — for example, if you have set up a new property or made a mistake — you can update the ID at any time:
- Manually clear the existing Measurement ID from the field and enter your new valid ID.
- Click Save. The old ID is overwritten and the new ID is stored.
2.5.2 Removing the Integration
If you want to stop tracking entirely and remove the GA4 integration from your portal:
- Manually delete the Measurement ID from the field so that it is empty.
- Click Save. The integration is removed from your portal configuration.
2.6 Permissions and Portal Status Restrictions
Access to the Analytics configuration page depends on the current status of your portal. If your portal is in any of the following states, the page will not be accessible:
| Portal Status | Analytics Page Access |
| Active | ✅ Accessible |
| Delete Pending | ❌ Not accessible |
| Deleted | ❌ Not accessible |
If you cannot access the page and believe your portal should be active, contact your portal administrator to verify the portal's current status.
3. Troubleshooting
| Issue | Likely Cause | Resolution |
| I saved a valid ID but analytics are not tracking on my live site | Google Analytics can take up to 24–48 hours to begin showing data after a property first starts receiving hits, so a short delay is normal. | Wait for a day or two before checking again. |
| I entered my ID and clicked Save, but the success message did not appear | The ID may appear valid but the Save action may have failed due to a temporary issue, or the format was still invalid. | Refresh the page and re-enter your Measurement ID. Check that it matches the format G-XXXXXXXXXX with no spaces. If the problem persists, try a different browser or contact support. |