Troubleshooting: GBP Audit & Reports

Fix GBP Placeholders on Public Report Links

🔍 Audit Your Site for Local SEO Wins

🛠️ Resolving GBP Audit Quota Errors

This guide explains what the GBP Audit quota is, why you may see an error when running an audit, and how to top up your quota so you can get back to work. 🔍 What the GBP Audit Quota Error Means Every Search Atlas plan includes a set number of Google Business Profile (GBP) audits you can run in each billing cycle. This number is your audit quota. Each time you generate a new GBP Audit report, one audit is deducted from that quota. If you see an error when starting a GBP Audit that mentions your quota, running out of audits, or being out of points, it means you have used all the audits available on your plan for the current billing cycle. The audit did not run, and your existing reports have not changed. Good to know: GBP Audits draw from a dedicated per-plan audit quota. Running audits does not reduce the Local SEO Points or heatmap credits available for your other tools. 📊 How to Check Your Remaining Audit Quota To see how many audits you have left in your billing cycle: 1. Click your avatar in the top-right corner of the platform. 2. Select Billing. 3. Open the Plans & Top-ups tab. 4. Review the quota details to see how many GBP audits remain for this cycle. 💳 How to Top Up Your GBP Audit Quota Yes, there is a way to top up. If you run out of audits before your quota resets, you can purchase additional audits in a few steps: 1. Click your avatar in the top-right corner of the platform. 2. Select Billing. 3. Open the Plans & Top-ups tab. 4. Choose a top-up option that includes GBP audits and complete the checkout. 5. Return to the GBP Audit tool and run your audit again. If you do not have a payment method saved yet, use the Add Payment Method button on the same tab before purchasing your top-up. Have a promo code? Use the Redeem Promo Code option in the Billing section to add extra quota to your account at no cost. If you regularly run out of audits, upgrading to a higher plan gives you a larger included audit quota every billing cycle. ♻️ When Your Quota Resets Your audit quota refreshes automatically at the start of each new billing cycle. If you prefer not to top up, simply wait for the reset and run your audit then. Audits that never started because of the quota error did not consume any of your quota. 🚫 If the Error Is Not Quota-Related Not every GBP Audit error means you are out of quota. The platform shows a distinct message for quota exhaustion, separate from other failure types. If your error mentions something else, such as an invalid Business Profile, a connection problem, or a data issue, try these quick checks: - Confirm the Google Business Profile you are auditing is live and publicly visible. - Double-check the business name and location details you entered. - Refresh the page and run the audit again. - Verify your account and billing are active in the Billing section. If the audit still fails after these checks, reach out using the chat option below and include the name of the business you were auditing so we can investigate faster. 💬 Still Need Help? If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.

🛠️ Resolving GBP Audit Quota Exhaustion Errors

The GBP Audit quota exhaustion error appears when your account has used all of the Google Business Profile audits included in your current plan for the billing period. This article explains what the error means, how to check your remaining allowance, and the fastest ways to get audits running again. 🤔 What the Quota Exhaustion Error Means Each Search Atlas plan includes a fixed number of GBP Audit runs per billing cycle, tracked as your allowed GBP audits. When you try to start a new audit after using your full allowance, the audit stops and the platform displays a quota exhaustion message instead of a report. - Quota message: you have used every audit in your current allowance. - Technical error message: the audit failed for another reason, such as an invalid profile or a data issue. These are separate states with distinct messages, so read the on-screen text carefully before acting. GBP Audits draw from their own dedicated quota. They do not consume Heatmap credits or Local SEO Points, so topping up those balances will not resolve this error. 🔍 How to Check Your Remaining Quota 1. Click your avatar in the top-right corner of the platform. 2. Select Billing. 3. Open the Plans & Top-ups tab. 4. Review the quota model details to see your plan's included GBP Audit allowance and current usage. The quota panel shows how many audits remain in your current billing cycle, so you can plan your runs before reaching the limit. 🔄 When Your Quota Resets Your GBP Audit allowance resets at the start of each billing cycle. If your error is caused purely by quota exhaustion and you do not need audits urgently, the simplest fix is to wait for the reset and re-run the audit afterwards. Your saved profiles and previously generated reports are not affected — nothing is deleted when you hit the limit. 💳 How to Top Up or Increase Your Allowance If you need additional audits before your reset date, all options are handled from the Billing area: 1. Click your avatar in the top-right corner of the platform. 2. Select Billing. 3. Open the Plans & Top-ups tab. From there, choose the option that fits your situation: - Buy a top-up: purchase additional GBP Audit runs that become available immediately. - Upgrade your plan: higher-tier plans include a larger monthly allowance of allowed GBP audits. - Redeem a promo code: if you have a promotional code, apply it from the Plans & Top-ups tab to add extra quota. If you do not have a payment method on file yet, use the Add Payment Method action on the same tab before purchasing a top-up or upgrading your plan. ✅ Best Practices to Avoid Exhausting Quota - Check your remaining audits under Billing → Plans & Top-ups before launching batch audits. - Run audits only for profiles you actively manage, and remove unused ones from your queue. - Space audits across your billing cycle instead of running them all at once. - Remember that audits which fail with a technical (non-quota) error message can be re-run and do not count toward your successful audit allowance. 💬 Still Seeing the Error After a Top-Up? If you have confirmed available quota or completed a top-up and the quota error still appears, refresh the page and re-run the audit once. If the error persists, our team can review your account's quota usage directly. If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.

🛠️ Fix the GBP Audit Out of Points Error

🔍 What Is This Error? When you run a GBP Audit or Heatmap ranking analysis, you may see an Out of Points error — even if your Local SEO Points balance appears to show points remaining. This is a known platform issue and is not caused by anything you did wrong. ⚙️ Why Does This Happen? The error is triggered by a quota issue that blocks GBP Audits and Heatmaps from running. The system incorrectly reports an out-of-points state that does not reflect your true available balance, causing audits and heatmaps to fail even when your visible point balance is not exhausted. 🚀 What You Should Do Right Now If you are currently blocked by this error, follow these steps: 1. Do not attempt to run the audit repeatedly — repeated attempts will not resolve the underlying issue. 2. Take a screenshot of the error message and your Local SEO Points balance for your records. 3. Contact our support team directly so we can investigate and help unblock your account. When reaching out, please have the following ready: - The name of the GBP project affected. - The approximate date and time the error occurred. - A screenshot of the error message and your points balance, if available. If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.

📍 Fix Local SEO Quota Exhaustion Errors

🔍 What Is a Quota Exhaustion Error? A quota exhaustion error means your account has used all the allocated points or credits for a specific feature. In the context of Local SEO, this most commonly affects heatmap keyword tracking. When your heatmap keyword quota runs out, Search Atlas pauses new scans and displays a quota exhaustion notice until additional points are added. This is not a bug — it is expected behaviour when your plan's included quota has been fully consumed. 📊 How Heatmap Keywords and Local SEO Points Work Local SEO features in Search Atlas — including heatmap keyword scans — are powered by Local SEO points. Each heatmap keyword scan consumes a set number of points depending on the grid size and scan frequency you have configured. Once your points balance reaches zero: - Scheduled heatmap scans will not run. - Manual scan requests will be blocked. - You may see a quota exhaustion warning inside the Local section. Adding more Local SEO points restores full access immediately without any changes to your existing project settings or historical data. 🗺️ How to Check Your Current Local SEO Points Balance 1. In the left sidebar, click Local to open the Local SEO section. 2. Click Overview (Left sidebar → GBP Projects → Overview). 3. Your current Local SEO points balance and usage breakdown are displayed at the top of the Overview page. 4. Review which projects or heatmap keywords are consuming the most points to help you plan future usage. ➕ How to Purchase Additional Local SEO Points 1. Navigate to Avatar → Billing → Plans & Top-ups. 2. Locate the points balance section and click Top Up or the equivalent purchase button shown on screen. 3. Select the points package that fits your needs and complete the checkout process. 4. Your new points are added to your balance instantly upon successful payment. 5. Any previously paused heatmap scans will resume on their next scheduled run. 💡 Tips to Avoid Running Out of Points - Audit your heatmap grid sizes. Larger grids consume more points per scan. Reduce the grid size on lower-priority keywords to extend your quota. - Review scan frequency. Daily scans use points faster than weekly scans. Adjust frequency based on how competitive or time-sensitive each keyword is. - Remove unused keywords. If a heatmap keyword is no longer relevant, delete it from your project to stop ongoing point consumption. - Monitor usage regularly. Check your balance in Avatar → Billing → Plans & Top-ups at least once a month to catch low balances before scans are interrupted. ❓ Frequently Asked Questions Has the quota exhaustion problem been fixed? Quota exhaustion is not a platform bug — it means your account's included Local SEO points have been fully used. Purchasing additional points resolves the issue immediately. Do I lose my heatmap data when quota runs out? No. All historical heatmap data and project configurations are preserved. Only new scans are paused until points are replenished. Will my quota reset automatically? Depending on your subscription plan, a portion of Local SEO points may refresh on your monthly billing cycle. Check your plan details in your account settings for exact reset terms. Purchased top-up points do not expire within your active subscription period. Can I set up a low-balance alert? Notifications and alert settings can vary by plan. Check your account notification preferences or ask via the chat widget for guidance specific to your subscription. 🆘 Need More Help? If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.

🔗 Fix Google OAuth Error 400 in GBP Audit

🔍 Overview When running a Google Business Profile (GBP) audit in Search Atlas, you may encounter the following error: Error 400: invalid_request. This is a Google OAuth 2.0 authorization error that occurs when your Google account connection has expired or become invalid. Clearing your cache or signing out will not fix this — the solution is to disconnect and reconnect your Google account directly inside Search Atlas. ⚠️ Why This Happens Search Atlas uses OAuth 2.0 to securely connect to your Google account and access your GBP data. Over time, this authorization token can expire or be revoked — for example, if you changed your Google password, revoked app permissions, or the token simply timed out. Once the token is invalid, any attempt to run a GBP audit will trigger the Error 400: invalid_request message from Google. 🛠️ How to Fix It: Reconnect Your Google Account Follow these steps to disconnect and reconnect your Google account to restore GBP audit access. 1. Navigate to the GBP or Local section of Search Atlas where your Google Business Profile projects are listed. 2. Locate the GBP project that is showing the authorization error. 3. Find the Google account connection option for that project — it will indicate that the authorization has expired or is no longer valid. 4. Disconnect or remove the expired Google authorization from the project. 5. Once disconnected, initiate a new Google account connection for the same project. 6. A Google sign-in window will appear. Sign in with the Google account that has access to your GBP listing and grant the requested permissions when prompted. 7. After successfully authorizing, return to your GBP project and relaunch the audit. The Error 400: invalid_request message should no longer appear and your audit will proceed normally. ✅ Confirm the Connection Is Working After reconnecting, verify the fix was successful before running a full audit: - Confirm your GBP location data is loading correctly within the platform. - Check that your GBP project no longer displays an authorization warning or error status. - Try running the audit again — if it progresses past the authorization step, the reconnection was successful. 🚫 What Will Not Fix This Error The following steps are commonly suggested for Google errors but will not resolve Error 400: invalid_request caused by an expired OAuth token: - Clearing your browser cache or cookies - Signing out of and back into Search Atlas - Using a different browser or incognito mode - Disabling browser extensions If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.

📊 Troubleshooting GBP Metrics Not Displaying in Report Builder

📋 Overview If you have added a Google Business Profile (GBP) section to your report but the metrics are not displaying, this article will walk you through the most common causes and their fixes. This applies even if you have already tried standard troubleshooting steps such as a hard refresh or adjusting your date filters. GBP metrics rely on an active integration and a properly saved report configuration. When one of these elements is disrupted, the section may appear empty, disappear entirely, or display inconsistently between the editor and the shared view. 🔍 Why Your GBP Metrics Are Not Showing There are several reasons GBP stats may fail to populate in the Report Builder, including: - The GBP section was removed automatically after saving the report configuration. - The connected Google Business Profile location has not synced enough data for the selected date range. - The date range falls outside the window where Google provides GBP insights (Google typically limits historical data availability). - The report was opened via a shared URL that displays a different layout or metric set than the editor. - The GBP integration disconnected or lost authorization since the report was created. 🛠️ Step-by-Step Fixes Work through the following steps in order. Most GBP display issues are resolved by re-verifying the integration and re-adding the section. 1. Navigate to Reports in the left sidebar to open your Report Builder projects list. 2. Open the affected report and confirm that a GBP section is still present in the layout. If it disappeared after saving, add it again from the section menu. 3. Confirm the correct Google Business Profile location is selected for the report. If no location is connected, reconnect your GBP account before proceeding. 4. Set the date range to a period within the last few months, as Google limits how far back GBP insights are available. Very recent dates (the last 2–3 days) may also lack data because Google reports insights with a delay. 5. After adjusting the section and date range, save the report configuration again to lock in your changes. 6. Perform a hard refresh of the page to load the updated metric cards. 🔗 Checking the Shared Report View If your GBP metrics appear correctly in the editor but are missing or look different in the shared report URL, this is often a layout-sync issue between the editor and the published version. - Return to the editor and confirm the GBP section displays as expected. - Re-save the report to force the shared URL to regenerate with the current layout. - Reopen the shared link in a fresh browser tab or incognito window to confirm the metrics now match the editor. 📈 Understanding GBP Metric Cards When your GBP metrics do load, you may notice several summary elements, including a Total Searches versus Maps Views summary bar and individual metric cards showing change deltas. Each metric card includes an arrow indicator that reflects whether a value increased or decreased compared to the prior period. If a card shows a delta but seems visually inconsistent, re-saving and refreshing the report will typically restore the correct display. ✅ When to Reconnect Your GBP Integration If the GBP section continues to show empty metrics after completing the steps above, the underlying integration may need to be reconnected: 1. Verify your Google Business Profile account is still authorized within the platform. 2. If authorization has lapsed, reconnect the account and grant all requested permissions. 3. Return to your report, re-add or refresh the GBP section, save, and reload. 💬 Need More Help? If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.

GBP Score Stuck on Calculating

📋 Overview If one or more of your Google Business Profile (GBP) locations shows all other metrics correctly but the overall GBP score remains stuck on Calculating for more than 24–48 hours, this article explains what causes the issue and how to resolve it. 🔎 What Causes This Issue? The GBP score is generated by a background process that runs on a scheduled cycle. In some cases, this process does not correctly pick up newly connected or recently updated locations, leaving the score indefinitely in a Calculating state. This is a platform-level issue — it cannot be fixed by refreshing the page alone. ✅ Steps to Resolve This Issue Follow these steps in order to get your GBP score unstuck as quickly as possible: 1. Wait 48 hours after first connecting a location. The GBP score calculation can take up to 48 hours for newly connected profiles. If the score updates within this window, no further action is needed. 2. Check all affected locations. Note how many of your GBP locations are showing the Calculating status and whether they are newly connected or have been active for some time. 3. Disconnect and reconnect the affected GBP location. If the score is still stuck after 48 hours, try removing the affected GBP location from your account and reconnecting it. This can prompt the background calculation process to re-run for that location. After reconnecting, allow another 24–48 hours for the score to generate. 4. Verify your GBP connection is active and authorized. Go to Left sidebar → Local → GBP Projects (GBP Projects | searchatlas.com) and confirm the location is connected with a valid, authorized Google account. An expired or revoked authorization can prevent the scoring process from completing. Re-authorize if needed. 5. Contact support if the score remains stuck beyond 48 hours after reconnecting. If the score has still not updated after attempting the steps above, reach out to our team. A server-level fix may need to be applied to your account by engineering. Provide the details listed in the next section so the team can escalate your case quickly. 📝 Information to Have Ready When Contacting Support To help our team escalate your case quickly, please have the following ready before opening a chat: - The names or URLs of the GBP locations affected - How long the score has been stuck on Calculating - Whether the locations are newly connected or were previously showing a score - Any troubleshooting steps you have already attempted If you need help, please reach out to our support team and we'll be happy to assist.

🔍 GBP Audit Stuck in Pending Status

🧭 Overview When you run a GBP audit, processing usually begins immediately and the audit status is tracked on screen. If the status has not updated after several minutes, the audit is likely stuck in a pending state. This is typically caused by a temporary background worker outage on Search Atlas's infrastructure — not by anything wrong with your account or your Google Business Profile. ⚠️ How to Recognise This Issue - You triggered a GBP audit and the status appeared but has not advanced for 5 or more minutes. - The audit status remains Pending with no error message displayed. - Other parts of the platform continue to work normally. 🛠️ What Causes It GBP audits are processed by a dedicated background worker. If that worker goes offline or becomes overloaded, audit tasks queue up and cannot progress until the worker is restarted by our engineering team. This is an infrastructure-level issue that cannot be resolved by changing settings inside your account. ✅ Steps to Take 1. Wait 10–15 minutes. Our monitoring systems detect worker outages automatically, and engineering teams are alerted to restart the worker as quickly as possible. In most cases the audit resumes on its own once the worker is back online. 2. Refresh the page. After waiting, navigate back to your GBP project and check whether the audit status has updated. 3. Do not submit the audit again. Triggering a second audit for the same profile while the first is pending can create duplicate tasks and delay resolution further. 4. Check back after 30 minutes. Once engineering restarts the worker, queued audits are automatically re-dispatched and should complete in the normal timeframe. 5. If the audit is still stuck after 30 minutes, contact our support team so they can escalate to engineering directly (see below). 📋 Information to Have Ready When Contacting Support To help our team investigate quickly, please have the following details available before reaching out: - The name of the GBP profile or project you were auditing. - The approximate time you triggered the audit. - A confirmation that the audit status has not changed for more than 30 minutes. 💡 What Happens Behind the Scenes When our engineering team is alerted, they restart the background worker responsible for processing GBP audit tasks. Once the worker is online, a recovery process automatically re-dispatches any audits that were stuck in the queue. You do not need to do anything for the audit to resume — it will pick up and complete without you having to retrigger it. 💬 Need Further Help? If the audit remains stuck after 30 minutes, please reach out to our support team and we will escalate to engineering on your behalf.