Connect Google Search Console — MerchantFlow

Connect Google Search Console to MerchantFlow

The Search Console integration connects your verified Google Search Console site to MerchantFlow through the shared Google OAuth flow. This brings organic search data -- queries, clicks, impressions, and average position -- into your e-commerce analytics dashboard alongside your paid advertising and commerce data.

What Is the Search Console Integration?

MerchantFlow's Search Console integration syncs organic search performance data from Google Search Console so you can track SEO visibility alongside your paid channels and commerce metrics. The integration provides:

• Search queries -- which keywords drive organic traffic to your store
• Clicks and impressions -- volume of organic search traffic
• Average position -- your ranking position for tracked queries
• Organic performance context -- enriches MerchantFlow reporting with SEO data

Availability

Search Console is off by default. It sits behind the per-workspace search_console_enabled feature flag while MerchantFlow stabilizes the organic-search data pipeline, and a MerchantFlow admin turns it on for a workspace.

When the flag is off:

• The Search Console row does not appear on the Google card in Settings > Integrations, and it is not offered in Configure Google Services
• MerchantFlow reports Search Console as not connected everywhere downstream -- sync health, integration validation, and the health roll-up
• Any Search Console credential you connected earlier is left untouched. Turning the flag back on resumes status reporting and syncing from where it left off

If you expect Search Console and do not see it, contact MerchantFlow support rather than reconnecting Google -- reconnecting will not surface a flagged-off service.

Two gates have to be open, not one. On top of the flag, Search Console data requires a Pro or Plus plan -- Starter workspaces have no access even where the flag is on, and the Search Console query endpoints refuse the request. The Traffic page in the dashboard is entirely Search Console-driven, so it disappears from your navigation whenever either gate is closed.

How to Connect Search Console

1. Connect Google from onboarding or Settings > Integrations
2. Open Configure Google Services
3. Choose the verified Search Console site you want to sync
4. Save the configuration

Search Console uses the same shared Google OAuth grant as GA4, Merchant Center, and Google Ads. The webmasters.readonly scope is requested as part of that single Google authorization, so there is no separate Search Console consent screen.

What to Expect After Setup

• MerchantFlow stores the selected siteUrl
• Future syncs use that site for all Search Console data pulls
• If you recently changed the selected site, a targeted Google sync via Manual Sync is the fastest way to refresh the data

Note: Search Console data is not perfectly real-time. Very recent days can lag behind actual store activity, which is a limitation of the Search Console API itself.

Troubleshooting Search Console Issues

If the site is missing from the configuration list:

• First confirm Search Console is enabled for your workspace -- when the flag is off, the whole service is hidden, not just individual sites
• Confirm the Google account has verified access to that Search Console property
• Reconnect Google if ownership or permissions changed
• Verify the site is actually present in Search Console for that Google login
• See Troubleshooting Integrations for additional help

Frequently Asked Questions

Why is my Search Console data delayed?

Search Console data from Google typically has a 2-3 day delay. This is a Google API limitation, not a MerchantFlow issue. The most recent days in your reports may show incomplete data.

Can I connect multiple Search Console sites?

Each MerchantFlow merchant workspace connects to one Search Console site. For multiple sites, use separate workspaces or an agency workspace.

How does Search Console data complement GA4?

GA4 provides traffic and session data after users arrive at your site. Search Console shows what users searched for before clicking through -- queries, impressions, and ranking positions. Together, they give a complete picture of organic search performance.

Related Guides

• Google Analytics 4 -- traffic and session data
• Merchant Center -- product feed diagnostics
• Google Ads -- paid search performance
• Integrations Overview -- all supported integrations

---

Last updated: August 29, 2026