Exporting results

Scan results are yours to keep and share. Exports fall into two groups: what you click in the app, and what your connected AI agent can produce for you.

The export folder

Everything you export from the app goes into one folder, organised by project and keyword:

GeckoGrid Scans/
  Silver Creek Heating & Air/
    emergency ac repair/
      2026-10-19.png
      2026-11-10.png
    scans 2026-11-11.csv

By default the folder is GeckoGrid Scans inside your Downloads folder. To keep it somewhere else, such as a synced client drive, open Settings > Application, find Export folder, and click Choose folder. Use default goes back to Downloads, and Open folder opens it in your file manager. A new location takes effect when you save settings.

PNG heatmap export

With any completed scan selected, click Export Image in the map view. The image is saved in the scan’s project and keyword folder and named for the day the scan ran, for example 2026-10-19.png, so a keyword’s images sort in date order. A notice confirms the export with a Show in folder button.

• Exporting the same scan again replaces its file instead of piling up copies.
• If a keyword was scanned twice in one day, the time is added to each name, for example 2026-10-19 0905.png.
• With a competitor’s grid on screen, the image is saved beside the main one with the competitor’s name added.

The image includes the full heatmap with every rank circle, the color legend, and the info panel with the company, keyword, scan date, and average rank.

Turn on auto-export in Settings > Results and every completed scan saves its PNG to the same place automatically, including scheduled and Scan All runs.

White-label exports

On Agency and Lifetime plans, Settings > White Label lets you hide the map legend logo or replace it with your own. The setting applies to the live map view and to every exported PNG, manual or automatic, so client-facing images carry your brand instead of GeckoGrid’s. Solo exports carry the standard GeckoGrid legend.

The same section holds the Report contact fields: a contact name, phone, and website shown in the footer of the reports your agent builds. Leave a field blank to keep that line off reports. The website must be a full address starting with http:// or https://, or Settings will not save.

CSV export from Scan History

On the project page, expand a keyword in Scan History, tick the scans you want (across as many keywords as you like), and click Export CSV. GeckoGrid saves one file to the project’s folder inside the export folder, named for the day you exported it, with a row per grid point: keyword, scan date, source (local or API), grid spacing, latitude, longitude, rank, and whether the business was found. See reading scan history.

CSV export through your agent

For the full top 20 results at every point, use your connected AI agent. An agent with GeckoGrid’s MCP tools can call export_csv on any scan and write the per-grid-point results, with the full top 20 per point, to your Downloads, Desktop, or Documents folder. The same data powers agent-built spreadsheets and reports. See connecting an AI agent.

Image exports through your agent

The export_scan_image MCP tool renders a heatmap offscreen and saves a timestamped PNG, with two extras the in-app export does not have:

• Zoom: render the grid cropped close, as in reports, or one level wider, like the live map.
• Competitor grids: pass a competitor’s place ID to render that competitor’s coverage from the same scan, useful for side-by-side comparisons.

The app must be running for agent exports, but the window is never taken over, and exports run one at a time. If the basemap fails to render, the export says so instead of saving a blank map behind the pins; retry the export in that case.