πŸ“Š Map a GA4 Property to a Project

Camilo Aponte

Camilo Aponte

Last updated on Nov 11, 2026

πŸ“Š What GA4 mapping does

Mapping links one Google Analytics 4 property to one GSC site. After you save it, GSC Pages and Site Audit for that site can pull sessions, users, and other GA4 metrics. Each site needs its own mapping, even when several sites share the same Google account. The same GA4 property can be mapped to more than one site. Report Builder keeps a separate GA property on each report.

βœ… Before you map a property

  • The Google account you connect must be able to open the GA4 property in Google Analytics.
  • Use a GA4 property, not a Universal Analytics property. Universal Analytics properties will not appear as valid GA4 sources.
  • The connected Google account must be authorized for Google Analytics and able to access the property. Search Atlas does not check whether that access is Viewer, Editor, or Administrator.
  • Confirm the property tracks the same website as the Search Atlas project.

πŸ”— Connect the Google account

  1. Open the project that should receive the GA4 data.
  2. Connect the Google account under Settings, in the integrations list, under Google Analytics. To map a property, open GSC Performance, find the site, and click Connect Google Analytics 4, or the GA4 Connected or GA4 Enabled badge.
  3. Choose Connect new GA account in Settings, or + Connect new GA4 account in the site settings, and sign in with the Google account that can access the GA4 property.
  4. When Google asks for permission, allow access to Google Analytics, then return to Search Atlas.
  5. Confirm the connected account email is the one you intended to use.

If a Google account is already connected but it is the wrong account, disconnect it and connect the account that owns or can view the property.

πŸ› οΈ Map the property to the project

  1. Stay on the same site and open Google Analytics 4 Settings. Use the GA4 Property dropdown in that modal.
  2. Select the GA4 property for this website. Match the property name and the site it measures.
  3. Save the selection. The project should now show that property as connected.
  4. Open a report that uses GA4 data and confirm metrics appear for the expected date range.
  5. Repeat these steps in every other project that needs its own property.

Mapping is per site. Selecting a property for one site does not assign it to your other sites.

πŸ’‘ If the dropdown shows no properties

An empty dropdown means Search Atlas has no GA4 properties from a connected Google account that is authorized for Analytics. Check these items in order:

  • Wrong Google user: The connected email may not belong to the Analytics account that holds the property. Reconnect with the correct user.
  • Missing permission: Ask a GA4 Administrator to add that Google user to the property with Viewer access or higher.
  • Analytics access was not granted: Disconnect Google Analytics in Search Atlas, connect again, and accept every requested Analytics permission.
  • Only Universal Analytics exists: Create or locate the GA4 property in Google Analytics, then refresh the dropdown.
  • Property is in another account: Open Google Analytics and confirm which account contains the property before you connect.
  • Changes need a refresh: After permissions are updated in Google, disconnect and reconnect, then reopen the dropdown.

πŸ“ˆ After the property is mapped

Give reports a short time to load the newly linked data. If a report still looks empty, check that the date range includes days when the GA4 property collected traffic and that the property is not filtered to a different domain. Changing the mapped property replaces the GA4 source for that project going forward.

πŸ’¬ Get help in the platform

If you need further assistance, open the chat widget in the bottom-right corner of the platform and send your message. A member of our support team will reply in the chat.

Was this article helpful?