Troubleshoot Google Reviews Issues in Magento 2

This guide helps diagnose and fix issues with Google Business Reviews. Start with the self-test command, then check the specific issue sections below.

Self-Test

Run the built-in diagnostic command:

bin/magento shopreview:googlereviews:selftest

This checks module configuration, account connections, and common issues.

Connection Issues

Can't load Google Reviews? Follow these steps to diagnose connection problems.

Verify Google Account Connection

Confirm Business Account Association

Review OAuth Permissions

Reviews Not Importing

1. Check Account Connection - Verify status in Marketing → Google Reviews → Accounts
2. Check Location Selection - Ensure locations are selected for import
3. Check Cron - bin/magento cron:run --group googlereviews
4. Manual Sync - bin/magento shopreview:googlereviews:sync --all
5. Check Debug Logs - var/log/googlereviews/debug.log
6. Verify Reviews Exist - Confirm your Google Business Profile has published reviews

Note: Only public reviews are imported. Reviews marked as private or pending won't appear.

Widget Not Displaying

1. Clear Caches - bin/magento cache:flush
2. Check Widget Configuration:
   • Verify Layout Updates are configured
   • Check store view assignment
   • Confirm container placement
3. Verify Reviews Exist - Check Marketing → Google Reviews → Reviews grid
4. Check Location Selection - Ensure widget has locations assigned (or uses default)
5. Check Theme Compatibility - Test on default Luma theme to isolate theme issues

No Reviews in Grid

If Marketing → Google Reviews → Reviews shows no data:

1. Account not connected - Set up and authorize at least one account
2. Locations not selected - Select locations to import from
3. Sync not run - Run manual sync: bin/magento shopreview:googlereviews:sync --all
4. No reviews on Google - The business has no public Google reviews yet

Debug Mode

Enable detailed logging for troubleshooting:

1. Go to Stores → Configuration → Magmodules → Google Reviews
2. Expand Debug section
3. Set Enable Debug Logging to Yes
4. Save and clear cache

Log location: var/log/googlereviews/debug.log

What to look for:

• API response errors
• OAuth token issues
• Connection timeouts
• Data parsing errors

Common Error Messages

"Invalid response from Google API"

"Failed to create Google account"

"No locations found"

Need More Help?

Documentation:

• All Help Articles - Complete documentation overview

Support:

• Contact Support - Get help from our team