Troubleshooting: Report Builder: PDF, Layout & Export
By Camilo Aponte
By Camilo Aponte
๐ ๏ธ Fix Report Builder PDF Export Truncation Issues
๐ ๏ธ Fix Report Builder Sections and Competitor Sync
๐จ๏ธ Fix Unwanted Icons in PDF Report Layout
๐ Overview Some customers notice an unexpected download or print icon appearing in the top-right corner of their exported PDF reports. This icon can make reports look unpolished when sharing them with clients. This article explains why it appears and how to remove it so your reports look clean and professional. ๐งฉ Why the Icon Appears The download or print icon is typically triggered by your browser's built-in PDF viewer settings, not by Search Atlas itself. When you preview or export a PDF report, your browser may overlay its own navigation controls โ including print and save icons โ on top of the document. This behaviour changed in recent browser updates, which is why you may not have seen it before. In some cases, the icon may also appear if you are viewing the report inside a browser tab rather than downloading it as a standalone file. ๐ ๏ธ How to Remove the Icon Follow these steps to export a clean PDF report without the unwanted icon: 1. Go to Reports โ Report Builder (Report Builder) in the left sidebar (URL: /report-builder/projects-list). 2. Open the report you want to export. 3. Click the Download .CSV button inside the Report Builder โ do not use your browser's built-in print or save function. 4. Once the file downloads, open it directly in a dedicated PDF viewer such as Adobe Acrobat, Preview (macOS), or any standalone PDF application instead of opening it in a browser tab. 5. The icon will no longer appear because it was added by the browser overlay, not embedded in the file itself. ๐ก Best Practices for Professional PDF Reports - Always download first, then open: Avoid previewing exported PDFs inside your browser tab. Open them in a dedicated PDF application for the cleanest view. - Use the in-platform export button: The export function inside Search Atlas generates a properly formatted file. Using your browser's print-to-PDF shortcut may add browser UI elements to the output. - Check your browser extensions: Some PDF-related browser extensions inject their own toolbar icons. Try disabling extensions temporarily if the icon persists after downloading. - Share the downloaded file directly: When sending reports to clients, attach the downloaded PDF file rather than sharing a browser preview link to ensure they see a clean document. ๐ Browser-Specific Tips - Google Chrome: Chrome overlays a toolbar on PDFs viewed in the browser. Always click the download arrow in Chrome's PDF toolbar to save the file before opening it externally. - Mozilla Firefox: Firefox has a similar built-in PDF viewer. Use File โ Save Page As or the in-platform export button to get a clean file. - Safari (macOS): Safari typically opens PDFs cleanly, but using the Search Atlas export button is still the recommended approach. - Microsoft Edge: Edge's PDF viewer may also show toolbar icons. Download the file first and open it in a standalone viewer. โ Confirming the Fix After following the steps above, your PDF report should display without any browser-generated icons. The document will show only your report content, your branding, and the sections you configured inside the Search Atlas report builder โ exactly as your clients expect to see it. ๐ Still Need Help? If you have followed all the steps above and the icon is still appearing in your exported PDF file, or if you believe the icon is being added by the Search Atlas platform itself rather than your browser, our team is happy to take a closer look. 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.
๐ ๏ธ Report Builder โ PDF Download & Public Share Link Troubleshooting
If your Report Builder PDF export fails or a public share link sends viewers to a login page, follow the section below that matches your symptom. Some issues have already been patched; one has a fix in progress. Note: This article covers Report Builder only. If you are troubleshooting a PDF export failure in the GBP Audit Report, that is a separate issue (tracked as GBP-1225) resolved at the platform level โ contact support if you still see that error. ๐ Identify Your Symptom First Match your symptom before following any steps โ each issue has a different fix: - PDF export fails (logged-in user): clicking Export returns a 404 error, the file never downloads, or the button shows no response. - Shared link opens directly to the login page: opening a public share link sends the viewer to the Search Atlas login page instead of displaying the report. - Refresh button inside a shared report crashes to login: the viewer successfully opened the shared report, but clicking a Refresh control inside a section (e.g., AI Summary) redirected them to the login page mid-session. - Public share viewer cannot export PDF: someone viewing a report via a public share link clicks Export to PDF and receives a permission error from the generate-pdf request. ๐ Fix a Failed PDF Export (Logged-In User) Follow these steps if your PDF does not download or returns an error while you are signed in: 1. Reload the Reports โ Report Builder (Report Builder) page and wait for the report to fully render before starting the export. 2. Click Download .CSV again. Do not navigate away while the export is processing. 3. Clear your browser cache, open a fresh tab, and retry the export. 4. If the report spans a large date range or contains many widgets, shorten the date range and export again. A successful export triggers a PDF download in your browser within a few seconds. If no download appears after 30 seconds, go to the If the Issue Persists section below. ๐ Shared Link Opens Directly to the Login Page If a public share link sends viewers to the login screen on the very first load, regenerate your share link: 1. Open the affected report in Reports. 2. Click the Share & Export button in the report (Reports โ Report Builder โ open report (Executive Summary)). 3. Select Generate New Link, or toggle the public link off and then back on if no regenerate option is shown. 4. Copy the new link and replace the old one everywhere you previously shared it. 5. Test the new link in a private/incognito window to confirm it loads the report without prompting for login. The new link opens the report directly for anyone who has the URL โ no login required. ๐ Refresh Button Inside a Shared Report Crashes to Login Previously, a Refresh control was exposed inside certain sections of a public shared report (such as AI Summary). When a viewer clicked it, the session would crash and redirect them to the login page mid-session. This has been fixed at the platform level โ the Refresh button has been removed from public shared reports, so no action is required on your end. If you still see a Refresh button on a shared report or experience a redirect-to-login mid-session, contact support with the report URL so the team can investigate. ๐ค Public Share Viewer Cannot Export PDF If a viewer accessing a report via a public share link clicks Export to PDF and receives a permission error (the generate-pdf request is rejected), this is a known issue with a fix currently in progress but not yet released. There is no self-service workaround available at this time. Contact Search Atlas Support via the in-app chat and include the share link and a screenshot of the error. The team will confirm the case and notify you when the platform update is released. In the meantime, exports performed by a signed-in user on the report owner's account continue to work normally. โ ๏ธ If the Issue Persists If any symptom continues after completing the steps above, gather the following before contacting support: - The name of the report and the exact error message or behavior you see. - A screenshot of the error, if possible. - Your browser name and version, and your operating system. - Whether you are signed in or viewing via a public share link. Reach out to Search Atlas Support via the in-app chat so the team can investigate your specific report configuration. ๐ฏ You now know how to handle PDF export failures, shared-link login redirects, the resolved Refresh-button crash, and the pending public-share PDF export issue in Report Builder. For a full walkthrough of Report Builder features and sharing options, see the Report Builder Overview article.
๐๏ธ How to Delete Reports in Report Builder
๐ Overview Deleting a report in Report Builder requires a specific action that is easy to miss. There is no delete option available when you click directly on a report to open it. The delete control is accessed from the reports list view, not from inside the report itself. Follow the steps below to delete a report successfully. ๐ Before You Begin - Make sure you have the correct permissions to delete reports in your workspace. - Deletion is permanent. There is no undo option once a report is deleted. - You must be in the Report Builder projects list view, not inside an open report. ๐๏ธ How to Delete a Report 1. In the left sidebar, click Reports. This takes you to the Report Builder projects list at /report-builder/projects-list. 2. Locate the report you want to delete from the list. 3. Hover over the report row to reveal the action controls. 4. Click the three-dot menu (โฎ) or the delete icon that appears on the report row. 5. Select Delete from the menu. 6. Confirm the deletion when prompted. The report will be permanently removed from your projects list. โ ๏ธ Why You Cannot Find the Delete Option Inside a Report When you open a report by clicking on it, the view switches to the report editor or preview mode. In this mode, there is no delete option available. You must go back to the main reports list to access delete controls. If you are searching for a radio button or a delete option within an open report, this does not exist in the current interface. โ Troubleshooting - No hover controls appear: Make sure you are on the projects list page (/report-builder/projects-list) and not inside an open report. Click Reports in the left sidebar to return to the list view. - Delete option is greyed out or missing: You may not have the required permissions for that report. Contact your workspace administrator to review your access level. - Report still appears after deletion: Refresh the page. The list may not update automatically in all cases. ๐ฌ 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.
๐ Report Builder Stability and UI Updates
Report Builder has received a set of targeted fixes and a UI improvement that make the tool more stable, accurate, and easier to navigate. โจ What's New This release ships three bug fixes and one UI improvement to Report Builder: - Executive Summary tab no longer loads empty: Opening a Full Report previously landed users on a blank Executive Summary tab. This has been resolved so the correct content loads immediately on open. - Facebook Ads integration hidden for GHL accounts: The Facebook Ads integration option was incorrectly visible inside Report Builder for GoHighLevel (GHL) accounts. It is now properly hidden for those accounts to avoid confusion. - Memory and stability leaks fixed: A MobX reaction leak, a ResizeObserver loop, timer leaks, and an unguarded DOM crash have all been resolved, resulting in a more stable and performant Report Builder experience. - Improved location display with tooltips: Location information is now displayed with tooltips for better readability, and the associated button label has been updated to be clearer. ๐ ๏ธ How to Use It 1. Navigate to Report Builder from the main platform menu. 2. Open or create a Full Report โ the Executive Summary tab will now load with content correctly. 3. Hover over any location entry to view the new tooltip with additional detail. 4. GHL account users will notice the Facebook Ads integration option is no longer displayed in the report configuration panel. ๐ What to Expect - Full Reports will open directly to populated content instead of an empty Executive Summary tab. - The platform should feel more responsive during extended Report Builder sessions due to the resolved memory and observer leaks. - GHL account users will see a cleaner integration list without the Facebook Ads option. - Location tooltips appear on hover and do not require any additional configuration. 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.
๐๏ธ Report Builder Layout Edit Mode Fix
The Classic Report Builder now correctly re-enters layout edit mode when the configuration panel is closed and reopened, ensuring a smoother and more reliable report-building experience. โจ What's New A bug has been fixed in the Classic Report Builder where closing and then reopening the configuration panel would prevent the report from re-entering layout edit mode. Previously, users who closed the configuration panel and attempted to reopen it would find themselves unable to make further layout edits, disrupting their workflow. This fix restores the expected behavior so that layout edit mode is consistently accessible every time the configuration panel is reopened. ๐ What to Expect With this fix in place, the Classic Report Builder behaves as intended throughout your session. You can now open and close the configuration panel as many times as needed without losing access to layout edit mode. No changes to your existing reports or saved configurations are required โ the fix applies automatically the next time you use the Classic Report Builder. 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 Report Builder PDF Download Failures
๐ Overview Some users encounter errors when attempting to download a PDF report from Report Builder. The download may fail silently, return an error message, or produce a blurred and unreadable file. This article explains the known causes and the steps you can take before contacting support. โ๏ธ Known Causes of PDF Download Failures Our engineering team has investigated and resolved several PDF-related issues in Report Builder, including: - PDF generation failing for publicly shared reports - Downloads returning a 404 error during generation - Downloaded PDFs appearing blurred or unreadable on certain devices - Multiple combined issues affecting PDF output quality and delivery These issues have been addressed through engineering fixes. If you are still experiencing a failure, follow the steps below. ๐ ๏ธ Steps to Troubleshoot 1. Refresh the report page. Navigate to Left sidebar โ Reports โ [Report] (Executive Summary) and use the Refresh Summary action to make sure the report is using the latest data before attempting the download again. 2. Try the download again. After refreshing, attempt the PDF download once more. Temporary generation errors sometimes resolve on their own after a refresh. 3. Test with a different report. Open a different report and try downloading its PDF. This helps identify whether the issue is limited to one specific report or affects your account more broadly. 4. Check your browser and device. Try the download using a different browser or on a different device. Some PDF rendering issues, including blurred output, have been linked to specific Windows environments or browser configurations. 5. Note the exact error message. If a specific error message appears during the failure, write it down. This detail significantly speeds up the investigation if you need to escalate to support. 6. Record how long the issue has been occurring. Knowing whether the problem started recently or has persisted for days helps the team identify the root cause faster. ๐ Information to Have Ready If You Contact Support If the steps above do not resolve the issue, the support team will need the following details to escalate efficiently: - The exact error message displayed during the failed download - The link or name of the affected report - How long the issue has been occurring - Whether the issue affects all reports or only specific ones - The browser and operating system you are using Having this information ready before reaching out allows the team to escalate directly to engineering without back-and-forth delays. โ What to Expect After Escalation When a PDF download failure cannot be self-resolved, our support team logs a ticket with the specialized engineering team. Once engineering identifies and deploys a fix, a support agent will verify the resolution directly in your account before confirming it with you. You do not need to take any action while the fix is in progress โ the team will follow up when it is confirmed resolved. ๐ฌ 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. Additional Notes The 'Generating PDFโฆ This may take up to a minute' message appears but the file never downloads even after several minutes. This is a backend issue not related to browser, internet connection, or report content, requiring support/engineering investigation.
๐ ๏ธ Fix Report Builder Widget Title Errors
๐ What Causes the Widget Title Error When you try to edit a widget title in Report Builder โ for example, changing the business name in brackets to identify which Google Business Profile (GBP) a widget tracks โ you may see a validation error when saving. The most common symptom is a misleading date range validation message that appears even when your date settings are correct. This is a known issue that affects the Classic View of Report Builder. The underlying bug has been patched, but if you are still encountering the error, your browser may be loading cached files from an older version of the platform. โ Steps to Resolve the Error 1. Use the New Report Builder. Navigate to Reports in the left sidebar. The updated Report Builder is the default view and does not have this bug. If you are in Classic View, switch back to the New Report Builder before editing titles. 2. Clear your browser cache. If the patch is deployed but your browser is still loading older files, clearing the cache and hard-refreshing the page will load the latest version of Report Builder. 3. Edit the widget title. Click on the widget you want to rename, locate the title field containing the business name in brackets, and enter your updated label. 4. Save the report. Click Save and confirm that the title updates without triggering a validation error. If the error persists after clearing your cache, go to Reports in the left sidebar, open the report (Executive Summary), and click Refresh Summary to force a data sync, then attempt to edit the widget title again. ๐ Workarounds for Integration Label Limitations Certain integrations โ including OTTO and Facebook โ do not yet support fully editable widget labels in Report Builder. This means the business name shown in brackets may be locked and cannot be manually changed for those specific integration types. Editable labels for OTTO integration are actively in development. Until that feature ships, use these workarounds to keep your reports organized: - Use Section Titles. In the New Report Builder, add a custom section title above each widget to clearly identify the business profile it represents. - Create separate reports per profile. Build one report per GBP location instead of combining multiple profiles in a single report. - Rename the report itself. Use a descriptive report name that includes the business identifier โ for example, Monthly SEO Report โ Downtown Dental. ๐ How to Edit Titles in the New Report Builder The New Report Builder makes it easy to customize section and widget titles. Follow these steps: 1. Open your report from the Reports list. 2. Click directly on the section or widget title text you want to change. 3. Type your new title, including any business name in brackets for easy identification. 4. Click outside the text field or press Enter to save your changes automatically. Section titles can be added, edited, or removed at any time without affecting the underlying widget data. โ ๏ธ Classic View Known Issues If you access a report through View (Classic) from the Reports list, be aware of the following limitations: - Editing widget titles may trigger a false date range validation error. - Section title widgets may not display correctly in custom layouts. - Some titles visible in individual sections may not appear on the full report page. For the best experience, use the New Report Builder for all title editing and report customization tasks. ๐ฌ 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.
๐ Report Download Button Grayed Out Classic Version
๐ Overview If the download button appears grayed out or unclickable in the Classic version of the Report Builder, you are not alone. This is a known issue that can affect specific projects even when other accounts and reports download without any problem. This article explains the most common causes and the steps you can take to resolve it. โ๏ธ What Causes the Download Button to Be Grayed Out? Several conditions can disable the download button in the Classic Report Builder: - Report data is still loading or refreshing. If the report has not finished processing, the download option will remain inactive until the data is ready. - A previous export attempt crashed or failed mid-process. A known bug in the Classic Report Builder can cause an export to crash before completion, leaving the button in a disabled state for that project. - An export error occurred silently. In some cases, an "Error During Export" occurs in the background without a clear on-screen message, which also disables the button. - The specific project has a data conflict. Certain projects can trigger download issues while all other reports in the same account work fine. This is often related to the volume or structure of the data in that particular report. ๐ ๏ธ Steps to Fix the Grayed-Out Download Button 1. Refresh the report data. Go to the left sidebar, select Reports, then open the affected report (Executive Summary) and click Refresh Summary. Wait for it to complete before attempting to download again. 2. Try the Download .CSV option directly from the project list. On the Reports projects list page, locate the affected report and click Download .CSV directly from the action row. This bypasses the Classic view entirely and can succeed even when the in-report button is grayed out. 3. Switch to the V2 view. From the project list, click View report next to the affected report. The V2 version has its own download functionality and is not affected by the same bug. Download your report from there while the Classic issue is being addressed. 4. Open the report in Classic view and reload the page. Click View (Classic) to open the report, then do a hard refresh of the page (Ctrl + Shift + R on Windows, Cmd + Shift + R on Mac). Check whether the download button becomes active after the page fully reloads. 5. Check your browser and clear the cache. A stale cache can prevent the button from rendering in its correct state. Clear your browser cache, close the tab, and reopen the report. 6. Test in a different browser. If the button remains grayed out, open the same report in a different browser to rule out a browser-specific conflict. ๐ When Only One Project Is Affected If every other report in your account downloads successfully but one specific project โ for example, a report tied to a particular domain โ remains stuck, this points to a data-level issue with that project rather than an account-wide problem. In this situation: - Use the View report option for that project as your primary download method until the Classic issue is resolved. - Try duplicating the report by creating a new report for the same project and see whether the fresh copy downloads correctly in Classic view. - Note the exact project name and URL so you can share these details with the support team quickly. ๐ก Classic View vs. V2 โ Which Should You Use? The Report Builder currently offers two views for every report: View (Classic) and View (V2). Both display your report data, but V2 is the more actively maintained version and is less prone to export errors. If you regularly work with the Classic view, consider using V2 as your default until the Classic download issue is fully resolved on all projects. ๐ Still Seeing the Issue? If none of the steps above resolve the grayed-out download button, the issue may require a manual review of the specific report and project data. 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.
๐ Report Builder Auto-Integration Selection Fix
A bug causing inconsistent auto-integration selection behavior between the legacy config drawer, V3 config drawer, and the create modal in Report Builder has been resolved. โจ What's New Auto-integration selection logic is now fully aligned across all three entry points in Report Builder: the legacy config drawer, the V3 config drawer, and the create modal. Previously, the selection behavior could differ depending on which drawer or modal you used to configure a report, leading to unexpected results. This fix ensures a consistent and predictable experience no matter where you configure your integrations. ๐ What to Expect If you configure auto-integration selection in any of the three Report Builder entry points, the behavior will now match exactly. No additional steps are required โ the fix is applied automatically. If you had previously noticed mismatches in integration selection between the legacy and V3 config drawers or the create modal, those discrepancies should no longer occur. 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.
๐ Recovering a Deleted Report Builder Layout
๐๏ธ Overview In Search Atlas, report layouts (also called templates) created inside Report Builder are permanently deleted the moment you confirm their removal. There is no recycle bin, undo option, or automatic backup for deleted layouts. This article explains what to do if you have accidentally deleted a layout and how to rebuild or restore your work. โ ๏ธ Why Deleted Layouts Cannot Be Automatically Restored When a layout is deleted from Report Builder (Left sidebar โ Reports), the action is immediate and irreversible at the platform level. This means: - The layout name, structure, and all saved configuration are removed from your account instantly. - There is no version history or trash folder for report layouts. - Other team members sharing the same workspace will also lose access to the deleted layout. - All versions of the layout, including those you may have edited over time, are also permanently removed. - Even our engineering team cannot retrieve a deleted layout once it has been removed. Because of this, we strongly recommend treating shared or frequently used layouts as permanent assets and exercising caution before deleting them. ๐ Step 1 โ Confirm the Layout Is Truly Deleted Before taking any further action, verify that the layout has been deleted and is not simply hidden or misplaced: 1. Go to Left sidebar โ Reports to open the Report Builder projects list (at /report-builder/projects-list), where all your current layouts are displayed. 2. Scroll through your full list of reports and layouts. 3. Use the search bar at the top of the list to search for the layout name (for example, Ryan). 4. Check whether any team member may have renamed or moved the layout. If the layout does not appear anywhere in the list after these checks, it has been permanently deleted. ๐ ๏ธ Step 2 โ Recreate the Layout Manually The fastest way to recover your workflow is to rebuild the layout from scratch inside Report Builder. Follow these steps: 1. Navigate to Left sidebar โ Reports. 2. Click New Report (or the equivalent create button) to start a blank layout. 3. Add the same sections, data widgets, and branding that were part of the deleted layout. 4. Give the layout a clear, recognisable name to avoid accidental deletion in the future. 5. Save the layout once you are satisfied with the configuration. If you or a colleague remembers the structure of the deleted layout โ such as the widgets, columns, filters, or data sources used โ jot those details down first to make the rebuild faster. This is the quickest path to resuming normal reporting. ๐ก Tips to Prevent Accidental Deletion in the Future - Duplicate layouts before editing. Before making major changes to a layout, create a copy so you always have a fallback version. - Use descriptive names. Clearly named layouts โ for example, including the client name, date, or report type โ are easier to identify and less likely to be mistakenly deleted by other team members. - Review before deleting. Always confirm the layout name and contents before clicking delete, as the action takes effect immediately with no confirmation step to reverse it. - Restrict access for shared templates. If a layout is used by multiple team members, communicate clearly before deleting it. Consider assigning layout management responsibilities to a designated person to reduce the risk of accidental removal. - Document your templates externally. For critical report structures, keep a brief written record of the widgets and settings used so rebuilding is straightforward if needed. ๐ Step 3 โ Contact Our Support Team If you are unable to recreate the layout or believe the deletion was caused by a platform error, our support team may be able to assist with further investigation. Please have the following information ready before reaching out: - The name of the deleted layout (for example, Ryan). - The approximate date and time the deletion occurred. - The email address associated with your Search Atlas account. - Any details about the layout structure or widgets it contained. 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 Report Builder Conversion and Cost Data Mismatches
Why Does This Happen? Discrepancies between your Google Ads or Meta Ads data and the totals shown in Search Atlas Report Builder are a known issue. This article explains what is happening and what information to have ready when you contact support so our team can investigate and resolve the mismatch for your account. Common Causes of Mismatched Data - Attribution window differences: Google Ads and Meta Ads apply their own default attribution windows. If your Report Builder date range does not align with the same window, conversion counts may differ. - Campaign-level vs. account-level aggregation: Conversions recorded at the account or ad-set level may not roll up to the campaign level in Report Builder, causing campaign rows to show lower or zero conversion figures. - Ads account connection state: If the Google Ads or Meta Ads integration was recently set up, had permissions changed, or encountered a sync error, data may be missing or incomplete until the issue is resolved on the backend. - Meta Ads conversions not appearing: If conversions exist inside Meta Ads but do not appear in Report Builder, this is a known data-pull issue that requires backend investigation. What to Have Ready When You Escalate Because this is a backend data issue, our team will need to investigate your specific account and report configuration. Before reaching out, please gather the following: - The exact name of the affected report or project in Search Atlas - The date range you are using in the report - Which platform is showing the discrepancy (Google Ads, Meta Ads, or both) - The specific metric that does not match (e.g. conversions, cost, cost-per-conversion) - A screenshot or note of the value shown in Report Builder versus the value shown in the ad platform - Approximately when you first noticed the discrepancy Having this information ready will allow our team to identify the source of the mismatch and apply the correct fix on the backend as quickly as possible. 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 Report Builder Full Report Errors
๐ What This Article Covers If you see an error when trying to view or download a Full Report in Report Builder, the most common cause is a disabled or disconnected Rank Tracker project connection. This is a known, fixable issue โ not a platform-wide error with no solution. Follow the steps below to restore the connection and get your report working. โ ๏ธ Why This Error Happens Report Builder's Full Report pulls live ranking data directly from your Rank Tracker project. If the connection between Report Builder and your Rank Tracker project has been disabled โ either manually or after a settings change โ the report cannot retrieve the data it needs and returns an error. No data loss occurs; the connection simply needs to be re-enabled. โ How to Fix It: Re-enable the Rank Tracker Connection 1. In the left sidebar, click Keywords, then select Rank Tracker (Keyword Rank Tracker). 2. Locate the Rank Tracker project that your Report Builder report is linked to. 3. Open the project settings (look for a gear icon or the project name menu). 4. Check whether the project connection is set to disabled or inactive. If it is, toggle it back to enabled or active. 5. Save your changes and return to Report Builder. 6. Try viewing or downloading the Full Report again. In most cases, re-enabling the connection resolves the error immediately. If the report does not load within a few minutes, try refreshing your browser tab. ๐ How to Confirm Which Project Is Linked If you are unsure which Rank Tracker project your report is connected to, follow these steps: 1. Open Report Builder and select the report that is producing the error. 2. Review the report settings or edit view to identify the name of the linked Rank Tracker project. 3. Navigate to Left sidebar โ Keywords โ Rank Tracker (Keyword Rank Tracker) and match that project name. 4. Proceed with the re-enable steps above. ๐ซ What This Error Is Not This error is not an uncatalogued or unresolvable platform error. If you have previously been told there is "no available workaround" for a Full Report error in Report Builder, that diagnosis was incorrect. The cause is almost always a disabled Rank Tracker project connection, and it has a straightforward fix. Always check the Rank Tracker connection status before assuming the error is unresolvable. ๐ก๏ธ How to Prevent This Error in the Future - Before disabling or archiving a Rank Tracker project, check whether any Report Builder reports are linked to it. - If you need to pause a Rank Tracker project temporarily, note which reports depend on it so you can re-enable the connection when nee
๐ ๏ธ Report Builder PDF Export Downloading Blank
๐ Overview Some users experienced an issue where downloading a PDF from Report Builder produced a blank or empty file. This affected all reports across the account, including monthly and client reports. A fix has been deployed to production and the issue is now resolved. ๐ Is This Still Happening to You? If you are currently seeing blank PDF downloads from Report Builder, try the steps below before contacting support. In most cases, the issue is resolved and a simple retry will produce a correct PDF. 1. Refresh the page. Close any open report tabs and reload the Report Builder page in your browser. 2. Clear your browser cache. Cached files can sometimes cause stale behaviour. Clear your cache and cookies, then log back into the platform. 3. Try a different browser. If the blank PDF persists in your current browser, open the platform in an alternative browser (for example, switch from Chrome to Firefox, or vice versa) and attempt the download again. 4. Re-generate the report before downloading. Open the affected report in Reports and trigger a fresh export rather than re-downloading a previously generated file. 5. Test with a different report. Try downloading a different report to confirm whether the issue is isolated to one report or affects all reports in your account. โ Confirmed Fix This blank PDF export issue was identified, escalated to the engineering team, and fully resolved. The fix is live in production for all accounts. You should now be able to download complete, correctly rendered PDFs from Report Builder without any further action required on your end. โ ๏ธ When to Contact Support If you have followed the steps above and are still receiving blank or empty PDFs, the issue may be specific to your account or a particular report configuration. Please reach out to our support team for further assistance.
๐ ๏ธ Fix Report Builder Edits That Disappear After Saving
What Is This Issue? Some users find that edits made in the Report Builder โ such as custom text changes, layout adjustments, or section modifications โ appear to save successfully but then revert or disappear when the report is reloaded. In some cases, connected data sources like Google Analytics may also become difficult to remove. This is a known issue that our engineering team has investigated. Follow the steps below to resolve it on your own, or contact our support team via the chat widget if the issue persists. How to Fix Disappearing Report Edits 1. Clear your browser cache and cookies. Cached data can interfere with how saved report data is loaded. Clear your cache, then reload the Report Builder and check whether your edits persist. 2. Try an incognito or private browsing window. Open the Report Builder in an incognito window to rule out browser extensions or cached sessions causing the revert behavior. Make your edits and save, then reload the page in the same incognito session to confirm whether changes are retained. 3. Try a different browser. If the issue only occurs in one browser, switching to another (e.g., Chrome, Firefox, Edge) can help confirm whether this is a browser-specific problem. 4. Re-save the report after each individual edit. If you are making multiple changes, try saving after each individual change rather than making all edits before saving. This can help isolate which specific edit is triggering the revert. 5. Remove and re-add connected data sources. If a connected data source such as Google Analytics appears stuck or cannot be removed, disconnect it from the report, save, then reconnect it and save again. Still Experiencing This Issue? If your report edits are still disappearing after following the steps above, please reach out to our support team via the chat widget so we can look into this further and escalate to engineering if needed. You can also email us at support@searchatlas.com.
๐ ๏ธ Fix Custom Text Not Saving in Report Builder
๐ Overview Some users have reported that custom text added inside the Report Builder does not save correctly โ edits appear to apply but then silently revert, or the changes are lost after refreshing the page. If you are experiencing this issue, please reach out to our support team so we can investigate and resolve it for your account directly. โ๏ธ What Was Causing This Custom text in the Report Builder was not persisting reliably for some users, causing edits to appear to save but then revert. The root cause of this behavior has not been fully characterized and may vary by account or configuration. Our support team will work with you to identify what is happening in your specific case. โ Steps to Resolve the Issue 1. Document what you are seeing. Note exactly when the text reverts โ for example, immediately after saving, after a page refresh, or after logging back in. This information will help our team investigate. 2. Attempt to save your custom text again. Navigate back to the Report Builder, re-enter your custom text, save the report, and refresh the page to check whether the changes persist. 3. Contact our support team if the issue continues. If your custom text is still not saving after retrying, reach out to us with details about your account, the report affected, and what you observed. Our team can look into the issue on the back end. ๐ก Tips to Prevent This Going Forward - Always confirm your changes have saved by refreshing the page after saving โ your custom text should still appear after a full reload. - If you encounter an error when saving, do not close the page immediately. Try saving again before navigating away. - Keep a copy of any important custom text outside the platform until the issue is confirmed resolved for your account. ๐ Still Having Trouble? If you have followed the steps above and your custom text is still not saving, please contact our support team via the chat widget so we can investigate further and apply a fix for your account.
๐๏ธ Deleted a Report Layout? What to Know and How to Rebuild
โ ๏ธ Deleted Layouts Cannot Be Recovered If you accidentally deleted a layout or template in Report Builder, unfortunately it cannot be restored. Deletion is permanent โ Search Atlas does not retain a backup of removed layouts, and there is no undo option available at this time. ๐ How to Rebuild Your Layout 1. Go to Report Builder from your Search Atlas dashboard. 2. Click Create New Report. 3. Add the same widgets, metrics, and data sources you had in the original layout. 4. Arrange and resize widgets to match your previous configuration. 5. Give the layout a clear, recognizable name before saving. ๐ก Tips to Avoid Accidental Deletion - Double-check the name before deleting โ Report Builder does not always prompt for confirmation. - Name layouts with the owner or purpose (e.g. "Ryan โ Weekly SEO Overview") for easier identification. - Periodically screenshot important layout configurations as a backup reference.
๐ง Fix PDF Download Stuck in Report Builder
What Is This Issue? When using the classic (old version) Report Builder, some users see the message "Generating PDFโฆ This may take up to a minute" but the download never starts. The file does not appear, even after waiting several minutes. What Caused the Problem? This issue is caused by an internal error in the PDF export process within the classic Report Builder. It is not related to your browser, internet connection, or report content, and requires investigation and action by the Search Atlas support or engineering team to resolve. How to Get Help Because this is a backend issue, the most effective next step is to contact the Search Atlas support team directly. To help the team investigate as quickly as possible, please have the following information ready before reaching out: - The exact report name โ the name of the report you were trying to export as a PDF. - A description of what you observed โ for example: "The PDF generation appears to start (the 'Generating PDFโฆ' message appeared) but the file never downloaded, even after several minutes." - When the issue occurred โ the date and approximate time, including your time zone. The support team will investigate the PDF export failure on the backend for your specific report and work with engineering if needed to resolve it. Contact Support If you're experiencing this issue, please reach out via the chat widget โ we're happy to help. If you need further assistance, please don't hesitate to contact us through the chat widget so the team can investigate the PDF export failure for your specific report.