# Changelog
{% updates format="full" %}
{% update date="2026-06-03" %}
## Redesigned PDF Export
The **Print Report** PDF has been reorganized for readability:
* **New cover page** — a larger map with an expanded legend (including the cannibalized area), alongside the GrowthFactor Score badge, the sales forecast with a visual confidence range, and a demographic snapshot. Your workspace logo appears when configured
* **Lens detail pages** — each GrowthFactor Score lens gets its own page with its score, grade, and the full reasoning behind it
* **Clearer export options** — each selected option becomes a separate page (PDF) or sheet (Excel), with Sales Forecast and Visitation listed first
## Multi-Select Model Inputs
Sales forecast model features can now accept multiple values. Multi-select features are marked **(multiple)** and display their options as clickable pills — toggle every option that applies to the site and the forecast updates accordingly.
## Improvements and Bug Fixes
* **Book a walkthrough** — a new link at the bottom of the sidebar opens a booking page where you can schedule time with our team for platform questions
* Re-inviting a deactivated member now automatically reactivates their account with prior workspace roles restored — no support request needed
* Fixed sharing maps via email; the share dialog now explains how to add multiple recipients, and the Share button works as soon as a valid email is entered
* Sites created from coordinates (CSV upload or MCP) now have their address split into proper street, city, state, and ZIP fields instead of one combined address line
* The Sales Forecast card now notes that the forecast is based on cannibalized sales
* Visibility is no longer included in the default GrowthFactor Score lens set for new organizations (existing configurations are unchanged)
* The Trade Area and Cannibalization map layers are now display-only and no longer show popups when clicked
* Removed the unused Custom Maps page
{% endupdate %}
{% update date="2026-05-12" %}
## Improvements and Bug Fixes
**Market Selection Workflow in the Agent**
Ask the Growthfactor Agent about a region (city or state) and it now responds with a rough market estimate built from demographics and site scores for the core nearby municipalities, plus a pointer to the full market selection product.
**Agent Reliability**
* Site scores in agent text now match the value shown on the map marker for the same location
* When a site score isn't available, the agent says so instead of falling back to a default value of 50
* Internal identifiers no longer appear in agent responses
* Gemini streaming errors (rate limits, transient failures) surface as readable messages in the chat instead of a generic error
* Fixed agent-generated map markers duplicating when navigating back to a conversation
**Other Fixes**
* Long-pressing on the map opens the context menu, making map interactions easier on touch devices
* The Deals map layer now respects your active workspace, so only deal pins from that workspace appear
* Long custom layer names in popup titles wrap instead of overlapping the close button
{% endupdate %}
{% update date="2026-05-07" %}
## Growthfactor Agent
Meet the **Growthfactor Agent** — a conversational AI analyst built into the GrowthFactor app. Ask it to find sites, score locations, pull demographics, run cannibalization, fetch foot traffic, and assemble trade zones. The agent carries out the work using the same tools you'd use yourself, and surfaces the results back as text, tables, and map layers.
* **Map layers from the agent** — trade zones, cannibalization, and candidate-site analyses run by the agent show up in the map legend so you can toggle them alongside your other layers
* **Trade zones on request** — specify a trade zone in your question and the agent uses that one instead of the workspace default
#### Market Selection Map Layer
A per-brand **Market Selection** map layer, powered by GrowthFactor's market-selection model, is available to select customers alongside your other custom layers. Reach out to to enable it for your brand.
#### Workspace Access and Mobile
* **Downward access for viewers** — viewers and members of a parent workspace can see sites, deals, custom layers, and shared maps from sub-workspaces they have access to
* **Site Score lenses for admins** — fixed an issue where workspace admins couldn't see Site Score lenses that exist on their workspace
* **Mobile workspace settings** — the Workspace Settings dialog (defaults, members, resources, site score) is usable on mobile
#### Cannibalization and Forecast
* **Store names alongside cannibalization addresses** — cannibalization results include the store name or ID next to the address, matching the analogs card
* **Removed outdated forecast disclaimer** — the "Forecast does not account for cannibalization" note has been removed; cannibalization is factored into the underlying model
* **More foot traffic data in PDF exports** — the PDF report export includes additional foot-traffic data for surrounding retailers, supporting side-by-side property overviews
#### Improvements and Bug Fixes
* The Deal Dashboard is now the default home page after login
* New filter UI for deals, sites, and files makes it easier to narrow large lists
* Fixed an issue where copied custom layers couldn't be renamed in their new workspace
* Hidden the draw button for polygon trade zones where it didn't apply
* Tag names can no longer be created blank
* Site sales values reject negative numbers
* Workspaces with no sites or no Site Score lenses return empty results instead of error toasts
{% endupdate %}
{% update date="2026-04-22" %}
## Workspaces
Workspaces let you organize your organization's data — stores, deals, layers, files, and more — into separate groups with independent access controls. Use workspaces to partition work by region, department, brand concept, or any structure that fits your team.
Workspaces form a tree hierarchy starting from a root workspace. Each workspace can have its own name, description, color, and settings — including model variables, trade zones, and brand behaviors — so different teams can tailor their analysis independently. Resources like deals, sites, tags, shared maps, custom layers, and files can be moved or copied between workspaces individually or in bulk.
#### Redesigned Workspace Switcher
The workspace switcher in the sidebar now lists every workspace you have access to, not just the ones you're a direct member of. Workspaces you have admin access to through a parent role but haven't joined directly show an inline **Join** option. Clicking it adds you as an Admin and switches you into the workspace.
Admins of the active workspace also see three quick-action buttons at the bottom of the dropdown:
* **+ New workspace** — create a sub-workspace with the active workspace as parent
* **Settings** — open Workspace Settings
* **Add member** — invite a teammate or new user directly to the active workspace
#### Consolidated Workspace Settings
Workspace administration now lives in a single dialog opened from the **Settings** button in the workspace switcher. The left pane is a workspace tree picker, the right pane has four tabs for the selected workspace:
* **Defaults** — preset, trade zone, tracked brands, and tracked categories that drive site analysis
* **Members** — the workspace's roster, with per-workspace Viewer / Member / Admin roles
* **Resources** — bulk-move (or, for custom layers, copy) deals, sites, shared maps, custom layers, files, and tags between workspaces
* **Site Score** — workspace context and lenses for the GrowthFactor Score
Workspace name, color, and description are editable inline at the top of the right pane, and a **+ Create sub-workspace** action is always one click away.
#### Move and Copy Files and Custom Layers Between Workspaces
Files and custom layers can now be transferred between workspaces, both individually (via each card's three-dot menu) and in bulk (from the Resources tab in Workspace Settings). Custom layers are **copied** so the original stays in the source workspace; files, deals, sites, shared maps, and tags are **moved** out of the source.
#### Members and Permissions
A redesigned **Members** page gives admins full control over who can access what. Each member can be assigned a Viewer, Member, or Admin role per workspace, with permissions flowing downward through the tree. The new **Viewer** role provides read-only access for stakeholders who need visibility without editing access.
#### Other Improvements
* **Known Issues** — a new entry in the help menu opens a public list of current platform issues, with statuses and last-updated dates so you can see what we're working on
{% endupdate %}
{% update date="2026-04-15" %}
## Ask AI Assistant
A new **Ask AI** button is now available in the Help menu across all dashboard pages. Click the **?** icon in the sidebar footer, then select **Ask AI** to open an AI-powered assistant that can answer questions about the GrowthFactor platform — without leaving the app.
The assistant comes with suggested questions to get you started, like "How do I create a new deal?" and "How do I search a site?", and can help you navigate features, understand data, and troubleshoot issues in real time.
#### Sites Page
Stores now open on a full dedicated page instead of the previous edit modal. Click any store in **My Stores** to open its detail page with a header, breadcrumb navigation, and four stat cards (Square Footage, Annual Sales, Sales / Sq Ft, and Open Date).
* Inline editing — click any store field to edit it in place with instant save
* Tags — add, remove, and create tags with autocomplete from your org's tag library
* Demographics — for geocoded stores, view trade-area demographics grouped into collapsible categories (Population, Income, Households, Education, and Growth) with top metrics highlighted
* New "Create Store" page — dedicated page with address autocomplete, store detail fields, tags, and a save bar
#### Smoother Org Switching
Switching between organizations is now more reliable:
* Same-org click — clicking the org you're already in no longer triggers a full reload — it shows a quick "Already in \[org name]" instead
* Member names — now update immediately after switching orgs
* Demographics — now always reflects the current org's settings after a switch
* Missing deals — navigating to a deal that doesn't exist in your new org now shows a helpful message instead of a broken page
#### Other Improvements and Fixes
* The Help menu now shows a live colored dot showing whether the platform is operational, degraded, or experiencing downtime
* GrowthFactor Score lenses now display in consistent chronological order instead of random order
* Fixed a bug that could cause GrowthFactor Scores to fail to load intermittently
* Fixed duplicate map layers appearing after navigating between deals
* Creating a store with an invalid address now returns a proper error message instead of failing silently
{% endupdate %}
{% update date="2026-04-08" %}
## Improvements and Bug Fixes
**Percent and Raw Toggle on Demographic Charts**
Demographic bar charts now include a toggle to switch between percent and raw value views, making it easier to compare data in the format most useful to your analysis.
**Vehicle Traffic GrowthFactor Score Lens**
Vehicle traffic data is now available as a GrowthFactor Score lens, giving you an additional dimension for evaluating site potential.
**Referral Button in Sidebar**
A new referral button has been added to the sidebar, making it easy to share GrowthFactor with colleagues and partners.
**Other Fixes**
* GrowthFactor Score lenses and results are now saved correctly on shared maps
* Fixed multi-point cannibalization not correctly including total store cannibalization data
* Fixed shared map creation failing when deal stages were duplicated
* Fixed an error that occurred when clicking "Done" on circle draw without drawing a circle
* Fixed demographic data failing to load in certain configurations
{% endupdate %}
{% update date="2026-04-01" %}
## Temporary Brand and Category Filtering
You can now personalize which brands and categories display on the Tracked POIs layer directly from the map. Click **Edit what's shown** under the Tracked POIs toggle to add or remove specific brands and categories from the display. Click **Apply** to confirm your changes, **Reset** to revert, or **Sync** to match your organization's current settings.
These edits are temporary and scoped to your session — they don't affect other team members or change your organization's permanent settings. For permanent changes, update your organization's presets in Organization Settings.
{% embed url="" %}
#### Other Improvements
**Other Improvements**
**Map Previews on Deal Dashboard**
Deal cards on the Deal Dashboard now display a map preview thumbnail instead of the previous analysis icon. Click the preview to jump directly into the full site analysis map, making it easier to visually identify and navigate to deal locations.
**GF Score Lens Weights and Data Source Configuration**
GrowthFactor Score lenses can now be weighted to reflect what matters most to your concept — if one or two scoring dimensions are more important, their weights can be increased so they contribute more to the overall score. Lens descriptions and data source connections can also be customized per lens. Reach out to the GrowthFactor team at to configure your lenses.
> :rotating\_light: **Known Issue**: The Shared Maps feature currently **re-generates the enhanced GrowthFactor Score** when it is shared. This will be addressed in the next release
**Updated Help Menu**
The help menu has been redesigned with a new icon-based layout in the sidebar, providing quick access to documentation, the product roadmap, feedback, and keyboard shortcuts.
**Other Fixes**
* Decimal radii are now supported for ring-based trade zones (e.g., 1.5 miles, 0.75 miles)
* Analog details modal now displays actual store numbers from your company instead of generic numbering
* Improved toggle interaction for site property fields based on user feedback
* "Save Changes" button on settings pages is now larger and more noticeable
* Hidden Dataplor score from the interface
* GF Score regeneration now properly regenerates all lenses when triggered from the Deal page
* GF Score prompts updated to provide more detailed answers and reasoning
* Tracked Businesses lens now includes distance context for improved analysis quality
* Admin users can now upload PDFs directly to the files page
* Added support for cannibalization in models
* Fixed heatmap layer not appearing on shared maps
* Fixed deal file updates sending incorrect format when modifying existing deals
* Fixed site ID names displaying with a `#` prefix in the analogs list
* Fixed text overflowing the text box during file uploads
* Removed foot traffic sort option from shared maps when foot traffic data is not shared
* Various UI refinements and styling improvements
{% endupdate %}
{% update date="2026-03-24" %}
## GrowthFactor Score Customization
Customize the prompts and data sources for GrowthFactor Score Data to make scores more accurate, helpful, and relevant to your business.
{% endupdate %}
{% update date="2026-03-20" %}
## Category & Name-Based Tracking
Competitive filtering now works by both category and name, across company size. In your settings, you can specify both names to track and categories to track. The UI displays results limited to your selections, with a gated number of categories or brands per account.
{% endupdate %}
{% update date="2026-03-18" %}
## New Full Deal Pages
We have shifted from the deal modal to full dedicated deal pages. Deals now open on their own page instead of a modal overlay.
* Responsive full-page layout with activity sidebar
* Centralized file uploads — single drag-and-drop for all file types, with tagging after upload
* Google Drive-style file cards with thumbnail previews, file info, and in-browser file previews
* Multi-file upload with per-file renaming
{% endupdate %}
{% update date="2026-03-04" %}
## "Local Business" Renamed to "Visitation"
We've renamed the "Local Business" section to "Visitation" across the platform, including in data cards, map popups, and report exports. This better reflects what the section actually covers: foot traffic data and nearby business rankings.
{% endupdate %}
{% update date="2026-03-04" %}
## Separate Share and Export Buttons
We've split the "Share & Export" button into two separate actions — "Share" and "Export" — each with its own dialog.
The Create Shared Map dialog now gives you granular control over what recipients can see. You can toggle visibility for specific data (Forecast, Visitation), individual cards (Analogs, Demographics, Score, etc.), and choose whether to limit the map to a territory boundary. All currently visible layers, including custom data layers, are included automatically.
The Export Report dialog lets you quickly select which sections to include in your print or Excel export without any of the sharing options getting in the way.
{% endupdate %}
{% update date="2026-02-12" %}
## See Existing Store Foot Traffic
Existing store foot traffic and trade zone data can now be viewed with a click for any pin on a map.
{% endupdate %}
{% update date="2026-02-05" %}
## "Open Report" Button for Sited Analysis Map
New "Open Report" button lets you analyze competitors on the Sited Analysis Map. When you click on a business on the map to see its visits, you can now open a report and run a GrowthFactor search on that specific location. This lets you dig into competitor demographics, customer draw, and potential brand cannibalization.
{% endupdate %}
{% update date="2026-02-05" %}
## Edit Deal Names in Deal Dashboard
Deal names can now be customized instead of just showing the address. This makes it easier to identify and manage deals the way you think about them.
{% endupdate %}
{% update date="2026-02-04" %}
## Customizable Forecasting Models with Flexible Feature Selection
You can now have our team use arbitrary site data to forecast anything — from sales, to memberships, to sales of specific retail baskets. Select from multiple forecasting models directly in the platform. Instead of filtering out sites to adjust your forecast, we now create tailored models for your store sets. Note that this means your selected filters will no longer affect your forecasting results.
We've also updated Excel and PDF exports to reflect which model and inputs were used to produce the forecast. Reach out to our team at to build and start using new models!
{% endupdate %}
{% update date="2026-02-04" %}
## Added Button in Sidebar to Product Docs
Added a "Help & FAQs" in the sidebar that links to the product documentation. This documentation explains each feature and how to use them. It also elaborates on best practices, tips, and frequently asked questions.
{% endupdate %}
{% update date="2026-02-04" %}
## Remove Forecasting Card for Users Without the Feature
For organizations that don't have forecasting models, we have hidden the forecasting card. This removes the default data from the site analysis page and report exports, streamlining the user experience.
{% endupdate %}
{% update date="2026-02-04" %}
## Bug Fixes and Minor Changes
**Minor Updates**
* Renamed "Quick Search" page to "Site Analysis"
* Renamed sales PSF on platform to "Forecast Midpoint" to better fit new, more general models
* Brand behavior inputs are now validated, and will error with "Invalid Brand Name" when incorrect slug is used
* Adding a brand behavior now auto-scrolls to the new row
* Deleting presets now requires confirmation, preventing accidental deletions
* Minor spacing and styling adjustments
* "Share" button has been renamed to "Share & Export" in hints and descriptions
* Added labels to "Download Deals" and "Dropbox" buttons on Deal Dashboard
**Bug Fixes**
* Improved foot traffic local totals for competitors/complements
* Fixed a bug where the address column from a CSV upload was ignored if a latitude and longitude were also provided
* Removed the toggle between Sales PSF and Total from sales forecasting — users can still toggle the results by clearing or re-entering the square footage
* Prevented saving brand settings changes while the page is still loading
* Corrected formatting on confirmation popups when optional label or cancel buttons are displayed
{% endupdate %}
{% update date="2026-01-23" %}
## Bug Fixes — Jan 23, 2026
This release resolves several bugs, including issues with foot traffic data, layer visibility, sales reporting, and version updates for the GrowthFactor tool.
* Foot traffic is now yearly
* Share Zoning Layer on Shared Maps
* Preserve layer visibility when you refresh the page
* Fix bug on total sales not showing in analog comparison screen
* Banner to indicate when a new version of GrowthFactor is available
{% endupdate %}
{% update date="2026-01-23" %}
## Scroll Bar Hidden When Not in Use
The scroll bar on the POI data card now disappears when not in use, improving the appearance of screenshots taken of the data card for analysis.
{% endupdate %}
{% update date="2026-01-14" %}
## Maps in PDFs
Improved PDF maps — the ability to include maps in PDFs has been added, improving exports from the platform.
{% endupdate %}
{% update date="2026-01-13" %}
## Users Can Now Persistently Access Their Reports
Users can now persistently access and customize their reports and analyses:
* Re-access the reports and analyses you have done for a site on the Deal Dashboard, allowing you to build upon your previous work
* Attach multiple analyses to each deal, allowing you to do "what ifs" and see how the numbers change if you tweak analysis parameters
{% endupdate %}
{% update date="2026-01-05" %}
## Integrated Data Sources Provide Comprehensive Business Insights
Integrated data sources provide comprehensive business insights by enabling access to a range of Tier 1 data, including customer site metadata, foot traffic, places data, and demographics. This lays the groundwork for incorporating additional data sources into our modeling — including site-specific metadata, foot traffic, and more.
{% endupdate %}
{% update date="2026-01-02" %}
## UI Refresh
Refreshed UI with improved map functionality:
* Easier access to create deals, share, and export
* Larger map view
* Clicking on a tracked business takes you directly to that business
* More demographic data highlights available
* Ability to run analysis by clicking on a map marker
{% endupdate %}
{% update date="2026-01-02" %}
## Remove Non-Logo Logos
Resolved customer feedback that single-letter logos can be confusing, especially when viewed at a distance, by removing non-logo logos.
{% endupdate %}
{% update date="2025-12-04" %}
## Growth Factor Analysis and Recommendations
The GrowthFactor Score feature provides an AI-powered analysis of a business's growth potential, synthesizing recommendations to help optimize their growth strategy based on factors like the surrounding area, market trends, and positioning.
{% endupdate %}
{% update date="2025-12-04" %}
## Deal Dropbox
The new Deal Dropbox allows external parties to quickly submit new sites to retailers. It automatically tags the submitted sites, runs them through the GrowthFactor AI model to generate a score and revenue forecast, and adds the deals to the retailer's dashboard. The Dropbox can also extract data from site flyers, eliminating the need for manual data entry.
{% endupdate %}
{% update date="2025-12-04" %}
## Unlimited File Uploads on Deal Dashboard
The Deal Dashboard now allows for unlimited file uploads, providing users with greater flexibility and storage capacity to manage their deals more effectively.
{% endupdate %}
{% update date="2025-12-04" %}
## Deal Dashboard Print, Export, and Other Minor Improvements
The Print Deal Dashboard has been updated to improve its functionality and user experience. We also enabled the ability to export to Excel, along with some performance improvements.
{% endupdate %}
{% update date="2025-11-17" %}
## Easier Way to Send Feedback
Contact button in the sidebar makes it easy to send us feedback.
{% endupdate %}
{% update date="2025-11-11" %}
## Customizable Shareable Maps
Brokers and franchise developers can now customize the insights they share with prospects, allowing them to highlight the most relevant data that supports their narrative without overwhelming the viewer.
* Toggle on/off key map layers or data panels: Demographics, Psychographics, Foot traffic trends, Vehicle counts, Competitor locations
* Shared version shows only what's selected — clean, focused, and persuasive
{% endupdate %}
{% update date="2025-11-09" %}
## Hide Cannibalization on Shareable Maps
You can now hide cannibalization on shareable maps, along with any other analysis dimension.
{% endupdate %}
{% update date="2025-11-03" %}
## Custom Layer Mapping
Comprehensive custom data layer functionality that enables users to create, edit, combine, and analyze custom geographic boundaries. This unlocks new spatial analysis capabilities for clients, allowing them to define territories that match their business needs and overlay custom data within those boundaries, leading to more informed location decisions.
{% endupdate %}
{% endupdates %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.growthfactor.ai/changelog/readme.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.