> For the complete documentation index, see [llms.txt](https://docs.growthfactor.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.growthfactor.ai/getting-started/workspace-settings.md).
# Workspace Settings
Workspace Settings is where each workspace is configured — name and color, members, default search parameters (trade zone, tracked brands, tracked categories), the resources it owns, and the lenses that power its [GrowthFactor Score](/analyze-site-intelligence-and-selection/growthfactor-score.md). Settings are scoped per workspace, so different teams in your organization can tailor analysis independently.
***
## Opening Workspace Settings
Workspace Settings is admin-only. Click the **workspace name** in the top of the left sidebar to open the workspace switcher, then click **Settings** at the bottom of the dropdown. (Members and Viewers don't see the Settings button — they see a short note pointing them to ask an admin.)
The Workspace Settings dialog opens with the active workspace selected. Use the tree on the left to switch between workspaces — clicking a workspace loads its settings on the right. The tree only shows workspaces you have admin access to.
Each workspace has five tabs: **Defaults**, **Members**, **Resources**, **Logo**, and **Site Score**.
***
## Workspace Header
At the top of the right pane, the selected workspace's name, color, and description are editable inline:
* **Color dot** — click to change the workspace color from the preset swatches or pick a custom hex
* **Name** — click to rename. Name must be unique among siblings
* **Add description** — click to add or edit an optional description
* **Member count** and **sub-workspace count** — quick stats for the workspace
* **Create sub-workspace** — opens the Create Workspace dialog with this workspace pre-selected as the parent
* **Delete** — appears in the top right for any workspace other than the one you're currently viewing. The root workspace and your current workspace cannot be deleted
{% hint style="info" %}
You can also create a new sub-workspace from the **+** button next to "Workspaces" in the left tree, which uses the currently selected workspace as the parent.
{% endhint %}
***
## Defaults Tab
The Defaults tab controls how site analysis runs in this workspace. This includes the default trade zone used for searches, which brands and categories appear on the Tracked POIs map layer, and the demographic variables behind your model.
### Preset
When a workspace has more than one preset, a **Preset** dropdown appears at the top of the tab. Use it to choose which configuration you're editing. Each option shows the brand and preset name. Some organizations have multiple presets for different store formats, regions, or concepts. Workspaces with a single preset don't show the dropdown.
### Trade Zone
The trade zone defines the geographic area used to calculate demographics and analyze site potential. It's used as the default for searches on the [Site Analysis](/analyze-site-intelligence-and-selection/quick-search.md) page. Each workspace has a single default trade zone.
If none is set, click **+ Add trade zone**. Otherwise the current zone appears as a card. Click it (or the pencil icon) to edit, or the trash icon to remove.
### Tracked Brands
Tracked brands are the specific brands that show up in the Tracked POIs map layer. Each row shows the brand name and its behavior. Click **+ Add brand** to add one, or click a row (or the pencil icon) to edit it; the trash icon removes it. For each brand, choose a behavior:
* **Drawn** — complement brands whose customers are likely to also visit you
* **Avoid** — competitor brands that draw from the same customer pool
* **Neutral** — brands to track on the map without factoring into scoring
### Tracked Categories
Tracked categories let you track entire business categories rather than a specific brand, useful when you want to monitor a type of business. The same Drawn / Avoid / Neutral behaviors apply. Click **+ Add category** to add a new entry.
### Demographic Variables
The demographic variables that drive analog matching and similarity scoring are listed in a table showing each variable's **code**, **metric**, and what it's **based off of** (its denominator).
To request a change, click **Change variables** to open the request form. Pick a request type — **Add new variables**, **Change existing variables**, or **Remove variables** — describe what you need, and submit. Your GrowthFactor team reviews the request and follows up.
{% hint style="info" %}
Use the [ESRI Data Browser](https://la.arcgis.com/databrowser-v2/index.html) to find variable codes. Include the full code with collection ID (e.g., `KeyUSFacts.TOTPOP_CY`) in your request.
{% endhint %}
***
## Members Tab
The Members tab lists everyone with a role on the selected workspace. Use it to invite new members, change roles, or remove access.
The list shows each member's email, name, role, workspace, and status. Use the search box to filter by name or email.
* **+ Add member** — invite an existing org user or send an invite to a new email
* **Three-dot action menu** — change a member's role (Viewer, Member, Admin) on this workspace, or remove them
See [Members](/getting-started/members.md) for full details on org-level vs. workspace-level roles, and the [Access vs. Membership](/getting-started/workspaces.md#access-vs-membership) distinction.
***
## Resources Tab
The Resources tab lists the resources owned by this workspace, grouped by type. Use it to bulk-move (or, for custom layers, copy) resources to another workspace.
1. Use the **type dropdown** to switch between Deals, Sites, Shared Maps, Custom Layers, Files, and Tags
2. Use the **search box** to filter the list
3. Check the items you want to move (or check the header checkbox to select all)
4. Choose a destination workspace and confirm
{% hint style="info" %}
**Custom Layers are copied** when you transfer them — a copy is created in the destination and the original stays in the source. **Files, deals, sites, shared maps, and tags are moved** — they're removed from the source. To duplicate a non-copyable resource, move a copy after the transfer.
{% endhint %}
***
## Logo Tab
The Logo tab manages a single workspace logo that appears in two places: on **site pins** across the map (replacing the workspace's initials) and in the **header of your public deal dropbox page**. Upload it once and it shows up in both. By default, site pins display the workspace color with the workspace's initials overlaid.
### Uploading a logo
1. Click **Upload logo** (or **Replace logo** if one already exists)
2. Select a **PNG, SVG, or JPEG** file under **512 KB**
3. To remove it and revert site pins to initials, click **Remove**
{% hint style="info" %}
Square images centered on a white background work best. Only one logo is kept per workspace; uploading a new image automatically replaces the previous one.
{% endhint %}
***
## Site Score Tab
The Site Score tab controls how the [GrowthFactor Score](/analyze-site-intelligence-and-selection/growthfactor-score.md) is generated for this workspace.
### Workspace Context
A short description of your brand, target customer, and strategic priorities that the AI uses when evaluating sites. A clear context helps the AI generate more relevant, calibrated scores. Edit it directly in the textarea.
### Lenses
Lenses are the scoring dimensions that make up the GrowthFactor Score. Each lens row shows its name, a **type** badge (e.g., "AI"), an optional **weight** badge when the weight isn't 1× (e.g., "2×"), a short description, and badges for any connected data sources. Each row has three controls:
* **Toggle** — enable or disable the lens for this workspace
* **Pencil icon** — edit the lens name, description, weight, and connected data sources
* **Trash icon** — remove the lens
Click **+ Create lens** to add a new lens. Each lens can be weighted to reflect what matters most to your concept — if one or two dimensions are more important, increase their weight so they contribute more to the overall score. Lenses can also be connected to specific data sources (demographics, nearby businesses, cannibalization analysis, analog stores) so the AI grounds its evaluation in real data.
***
## Creating a Sub-Workspace
To add a child workspace from inside Workspace Settings:
1. Open Workspace Settings (workspace switcher → **Settings**)
2. Either click **+ Create sub-workspace** in the top right of the right pane, or click the **+** button next to "Workspaces" in the left tree
3. Confirm or change the **Parent Workspace** in the dropdown
4. Enter a **Name** (must be unique among siblings)
5. Optionally add a **Description**
6. Choose a **Color** from the presets or use a custom hex
7. Click **Create Workspace**
***
## Requesting Model Changes
The fastest way to change the demographic variables that drive analog matching and similarity scoring is the **Change variables** button in the Defaults tab's [Demographic Variables](#demographic-variables) section. The request form lets you **add**, **change**, or **remove** variables and routes your request to the GrowthFactor team for review.
For broader model work — building segmented models for different store formats, regions, or concepts — contact your GrowthFactor team at .
***
## Related Features
* [Workspaces](/getting-started/workspaces.md) — the workspace tree, switcher, and access vs. membership
* [Members](/getting-started/members.md) — org-level roles and the Members page
* [GrowthFactor Score](/analyze-site-intelligence-and-selection/growthfactor-score.md) — how scores are generated
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.growthfactor.ai/getting-started/workspace-settings.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.