Appearance
Sites
The Sites tab is the central place to view and manage all sites within your project. You can find it by clicking the Sites tab in the map toolbar at the top of the page after entering a project.
Site Types
Every site has a type, indicated by a colored badge on its row:
| Badge | Type | Description |
|---|---|---|
| E (blue) | Existing | Current, open sites already operating |
| P (green) | Proposed | Potential future sites being evaluated |
| I (orange) | Layer / Interest | Points of interest imported from data layers |
| S (red) | Search | Custom pins you drop on the map to evaluate a location |
Searching Sites
Use the search bar at the top of the Sites panel to find sites by text. The search matches against:
- Site name
- Street address
- City
- State
- Postal code
Results update in real time as you type — no need to press Enter.
Filtering by Type
The filter bar at the top of the Sites panel contains type toggle badges (E, P, I, S). Each badge controls the visibility of that site type independently.
- Click a badge to toggle that type on or off
- Multiple types can be visible at the same time
- A faded, desaturated badge means that type is currently hidden
- All types are shown by default
When any filter is active, a Filtered indicator appears next to the site count. Click Clear next to the indicator to restore all defaults at once.
TIP
Combine text search with type toggles to quickly narrow down a large site list. For example, hide Existing and Interest sites and search by city to focus on Proposed sites in a specific market.
Advanced Subtype Filtering
Click the Advanced button (filter icon) in the filter bar to open the Advanced Filters panel. This lets you filter sites down to specific subtypes within each category.
The panel has three collapsible sections — Existing, Proposed, and Interest — one for each site type. Click the arrow next to a section name to expand or collapse it.
Within each expanded section, each subtype row shows:
- A site type icon
- The subtype name
- The count of sites with that subtype
Use the checkboxes to include or exclude individual subtypes. The header checkbox for each section toggles all subtypes in that section at once. The count display (e.g., 3/10) shows how many sites in that type are currently passing the filter versus the total.
Click Clear All inside the panel to reset all subtype selections.
INFO
Only subtypes and Interest layers that have at least one site loaded in the current project appear as rows in the Advanced Filters panel.
Sorting Sites
Click any column header to sort the site list by that column. Click again to toggle between ascending and descending order.
Available sort columns:
| Column | Description |
|---|---|
| Name | Site name, alphabetical |
| Address | Street address, alphabetical |
| Category | Site category label (see Site Categories) |
| Revenue | Revenue value, numerical |
| City | City name, alphabetical |
| State | State abbreviation, alphabetical |
The quick-sort bar at the top of the list provides one-tap access to common sort options without needing to open column headers.
- ↑ = ascending order (A → Z, lowest → highest)
- ↓ = descending order (Z → A, highest → lowest)
Site Details
Site Detail Tabs
Each site you open gets its own dedicated tab in the map panel. Multiple sites can be open at the same time, letting you switch between them without losing context. Each tab shows the site's icon and name, and can be closed independently.
A site tab shows:
- Header — site type icon (click to change type or category), category label, site name, and full address
- Revenue (existing sites only) — a breakdown of revenue by type, with a total revenue badge
- Estimated Revenue (proposed, layer, and search sites) — Zeustimate predictions for each configured revenue type; see Zeustimate Estimates below
- Smart Comparables — existing sites in your project most similar to the selected site; see Smart Comparables below
- Forecast Drivers — the variables and categories with the strongest impact on this site's Zeustimate forecast; see Forecast Drivers below
- Details — address fields, coordinates, and the count of site attributes
Opening a Site Detail tab
There are two ways to open a Site Detail tab for a site:
- Click a site icon on the map — click any site marker directly on the map; a tab opens for that site (or the existing tab gains focus if the site is already open)
- Locate from the Sites list — click the locate icon on a site row in the Sites panel; the map pans and zooms to the site and its tab opens
Closing a Site Detail tab
Click the × button on a site tab to close it. If multiple site tabs are open and the tab strip is wider than the panel, the active tab scrolls into view automatically. When the last site tab is closed, the panel returns to the Sites tab.
Inline row details
The site type icon on the left side of each row is a clickable button. Click it to open the type and category picker for that site without first opening a Site Detail tab.
Click the expand arrow on any site row to reveal a summary of its details inline within the list:
- Address — full street address, city, state, and postal code
- Coordinates — latitude and longitude
- Revenue — displayed as a colored badge indicating the revenue tier
- Site Attributes — additional metadata fields configured for your project (e.g., square footage, trade area population, nearby competitors)
Zeustimate Estimates
For proposed, layer, and search sites, the site detail tab includes an Estimated Revenue section powered by Zeustimate — Zeus.ai's AI-based revenue prediction model.
| State | What you see |
|---|---|
| Loading | A spinner with the message "Loading site attributes…" or "Calculating Zeustimate…" |
| Results | A list of revenue type estimates; estimates flagged as unusually high are labeled High in amber |
| No results | "No estimate available." — the model did not return a prediction |
| Error | "Failed to calculate revenue estimate." with a Retry button |
TIP
If you see an estimate labeled High, the model has detected the prediction is unusually elevated compared to similar sites. Review the site's attributes and location context before relying on this estimate.
Smart Comparables
The Smart Comparables section appears in the Site Detail tab and surfaces existing locations within your project that are most similar to the selected site, based on demographic and business attributes.
How comparables are sourced
The section builds its list differently depending on the selected site's type:
| Site type | Revenue source used |
|---|---|
| Existing | The site's actual revenue data |
| Proposed, Layer, Search | The Zeustimate prediction for the site (the section waits for Zeustimate to finish loading before fetching comparables) |
Reading the comparables list
Each row represents a comparable existing site in your project, ranked from most similar to least:
| Column | Description |
|---|---|
| Rank | Position in the list, with #1 being the closest match |
| Comp Site | Site icon, name, and address of the comparable location |
| Score | Match score as a percentage — how closely the comparable resembles the selected site |
| Revenue | A color-coded letter grade and the comparable site's total revenue (e.g., A $1.50M). Empty when no revenue is recorded. |
The Match Score column is color-coded by similarity strength:
| Color | Score range | Similarity |
|---|---|---|
| Teal-green | ≥ 90% | Excellent |
| Emerald | ≥ 80% | Very Good |
| Mint | ≥ 70% | Good |
| Amber | ≥ 60% | Decent |
| Orange | ≥ 50% | Average |
| Red | < 50% | Poor |
Revenue grade
The Revenue column shows each comparable's total revenue in a single rounded pill that combines a letter grade (A–F) with the formatted amount. Hover the pill to see the performer label and revenue:
| Grade | Performer label |
|---|---|
| A | Top Performer |
| B | High Performer |
| C | Average |
| D | Below Average |
| F | Needs Improvement |
The pill color is theme-aware and stays consistent across light and dark modes.
How grades are calculated
Grades are computed against the project's mature pool — the set of existing sites in the Mature category that have a recorded total revenue.
Percentile-based (default) — when the mature pool has at least 5 sites, the comparable's revenue is graded by where it falls in that pool: top 20% = A, next 20% = B, middle 20% = C, next 20% = D, bottom 20% = F.
Absolute thresholds (fallback) — when the mature pool has fewer than 5 sites, fixed revenue thresholds are used instead:
Grade Revenue A ≥ $1,000,000 B ≥ $500,000 C ≥ $250,000 D ≥ $100,000 F Below $100,000
TIP
Because percentile-based grading is relative to your project's mature sites, a grade of A means the comparable is performing well within your portfolio — not against an industry-wide benchmark.
Toggling columns
Click the gear icon in the Smart Comparables header to open the display settings. Use the checkboxes to show or hide:
- Rank — the rank badge on each row
- Match Score — the color-coded similarity percentage
- Revenue Grade — the Revenue column showing the letter-grade pill and amount
Your column preferences are saved per project.
Locating a comparable site
Click any row in the comparables list to pan and zoom the map to that site's location.
Loading and error states
| State | What you see |
|---|---|
| Loading | A skeleton placeholder that mirrors the table layout while data is being fetched |
| No results | "No comparable locations found for this analysis." inside a dashed border |
| Error | "Failed to load comparable locations." with a Retry button |
Forecast Drivers
The Forecast Drivers section appears in the Site Detail tab and shows which variables and categories have the strongest impact on this site's Zeustimate forecast. Use it to understand why the model predicted what it did, and to compare each driver's contribution against the underlying data points.
Categories and Variables views
A pill toggle at the top of the section switches between two views:
| View | What you see |
|---|---|
| Categories | Drivers grouped into category rows (e.g., Population, Income, Traffic). Each category row shows the total impact of all variables in that group. |
| Variables | A flat list of individual variable rows, ranked by the selected sort order. |
In Categories view, click any category row (or use Enter/Space) to expand it and see the individual variables that contribute to that category. The Expand all / Collapse all button on the right toggles every category at once.
INFO
The Categories view always renders every category and every variable underneath. Row-count limits only apply to the Variables view.
Reading the impact bar
Each row shows a horizontal impact bar that visualizes how much that variable or category pushes the forecast up (positive) or down (negative). Bar width is scaled to the largest absolute impact in the current view, so the longest bar reaches the edge of the column.
Two bar layouts are available via the gear menu:
| Layout | Behavior |
|---|---|
| Stacked | Bars all start from the left edge. Negative-impact bars use the downside color, positive-impact bars use the upside color. |
| Diverging | Bars are centered on a vertical zero line. Negative impact extends left, positive impact extends right. |
Hover any impact bar to open a tooltip with more detail:
- Variable rows show the variable name, its category description, the variable's local impact on this site, and the variable's Global impact (how influential it tends to be across the model overall).
- Category rows show the category name, its description, the Total impact for that category at this site, and the Variables count.
Display options (gear menu)
Click the gear icon in the Forecast Drivers header to open the display settings. Your choices are saved per project for your account.
| Setting | Options | Behavior |
|---|---|---|
| Sort by | Largest impact / Signed impact / Alphabetical | Largest impact ranks by absolute impact (biggest movers first). Signed impact puts positives before negatives. Alphabetical sorts by name. |
| Show top | 10 / 25 / 50 / 100 / All | Caps the number of rows in the Variables view. Disabled and muted while Categories view is active. |
| Bar layout | Stacked / Diverging | Switches between left-anchored stacked bars and center-anchored diverging bars. |
| Use category colors | On / Off | When on, each variable's bar and icon use its category's brand color instead of the default upside/downside palette. |
| Show value labels | On / Off | When on, a signed percentage (e.g., +3.2%, −1.8%) appears in a right-hand Value column. |
| Show 0%/null variables | On / Off | When off, variables and category totals with negligible impact (effectively zero) are hidden. |
Loading, error, and empty states
| State | What you see |
|---|---|
| Loading | A skeleton placeholder that mirrors the list layout while drivers are being fetched. The section also waits for the site's attributes to finish loading before requesting drivers. |
| No results | "No variable impact data available" inside a dashed border. This typically means the model did not return any driver data for the site. |
| Error | "Failed to load forecast drivers." with a Retry button. |
TIP
If most of your drivers are clustered near zero, try turning Show 0%/null variables off, or switch Sort by to Largest impact to push the most meaningful drivers to the top.
Site Categories
Sites are organized into categories based on their type and lifecycle stage.
Existing Site Categories
| Category | Description |
|---|---|
| Mature | Established sites with stable performance |
| New | Recently opened sites |
| Closed | Sites that are no longer operating |
| Temp-Closed | Sites that are temporarily closed |
| Non-Traditional | Non-standard format sites (e.g., kiosks, food trucks) |
Proposed Site Categories
| Category | Description |
|---|---|
| Consideration | Early-stage sites being considered |
| LOI | Sites with a signed Letter of Intent |
| Approved | Sites approved for development |
| In Development | Sites currently being built out |
| Non-Traditional | Non-standard format proposed sites |
| Rejected | Proposed sites that were not approved |
| Dead Deal | Proposed sites that were abandoned |
| Trade Area Seeds | Seed sites used for trade area analysis |
Changing Site Type or Category
You can change a site's type and category directly from the Sites panel without opening a separate edit form.
Opening the type picker
Click the site type icon — the colored symbol at the far left of any site row in the Sites panel, or at the top-left of the site detail tab header. A popover opens listing all available types and categories grouped into three sections:
| Section | Contents |
|---|---|
| Existing Sites | All existing-site categories (Mature, New, Closed, etc.) |
| Proposed Sites | All proposed-site categories (Consideration, LOI, Approved, etc.) |
| Competition | Competition layers configured for the project |
The site's current type and category is marked Current in the list and cannot be re-selected.
Confirming the change
Selecting a different type or category shows a confirmation dialog before the change is applied. The dialog style varies based on the conversion:
| Conversion | Dialog type | Warning shown |
|---|---|---|
| Within the same type (e.g., Existing → different Existing category) | Info | None — no data is affected |
| Existing → Proposed | Warning | Revenues will be lost |
| Proposed → Existing | Info | None |
| Existing → Layer | Warning | Revenues and some attributes will be lost |
| Proposed → Layer | Warning | Attributes will be lost |
| Layer → Existing or Proposed | Warning | Attribute fields will need to be populated |
| Search pin → any type | Info | Converts the search pin to a saved site |
Click Confirm or Convert to apply the change, or Cancel to keep the existing type.
Deleting a site from the type picker
The bottom of the type picker includes a Delete option. Clicking it opens a confirmation dialog before the site is removed.
WARNING
Deleting a site is permanent. All data associated with the site — including attributes and revenue records — will be removed and cannot be recovered.
Search Pins
Search pins are custom map markers you can drop anywhere on the map to evaluate a location that isn't already a project site.
Adding a search pin
Click and hold on any point on the map for about half a second. A pin drops immediately at the selected coordinates and a pulsing highlight ring appears at that location while it resolves.
The pin's name resolves to the nearest street address via reverse geocoding. Two validation checks run automatically:
- Country check — if the location falls outside the project's country, the pin is discarded and a warning appears: "Location is not within this project's country code."
- Address completeness check — if a full street address, city, and state cannot be determined, the pin is discarded and a warning appears: "Complete address information could not be found for this location. Please try again."
If both checks pass, the pin is saved with its resolved address.
Managing search pins
Search pins appear in the Sites panel under the S filter, alongside your other site types. You can:
- View details — expand a search pin row to see its resolved address and coordinates
- Locate on map — click the locate icon on a pin row to pan and zoom to the pin; a pulsing highlight ring marks its position on the map
- Remove a pin — use the delete action on the pin row
Persistence
Search pins are saved per project. They persist across browser sessions so you can close and reopen Zeus.ai without losing your pinned locations. Pins are stored only in your browser and are not visible to other users.
Locating a Site on the Map
Click the locate icon on any site row in the list to pan and zoom the map to that site's location and open its site detail tab.
INFO
This is a quick way to compare multiple sites side-by-side. Each site you locate opens in its own tab, so you can switch between them without losing your place.