> 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/study/overview.md). # Studies Overview ## What a Study Is A study is where your market exploration and analysis live. You drop pins, draw shapes, add annotations, and run analysis on the map — all of it saved as you go. This work can also be seen and continued by team members with access. Studies are listed on the **Studies** tab in the sidebar, along with the **Starred** and **Recents** sections. *** ## Creating a Study Click **New study** on the **Studies** page, from the sidebar, or on [Home](/getting-started/home.md). The new study opens with the name **Untitled study**. You need edit access to the workspace to create a study; viewers will see the list but not the button. Searching an address or asking a question in Home's search bar also starts a study — see [Home](/getting-started/home.md#search). *** ## Naming a Study ### Automatic Naming As you begin working in a new study, a title is generated for it automatically. This happens a few seconds after you add your first pins or trade zones, or as you begin chatting with the agent. Auto-naming only happens when the study is untitled, so it never overwrites a name you chose. ### Renaming a Study Click the study name at the top of the Study panel and type a new one. You can also click **Rename** in the **⋯** menu next to any study on the **Studies** page. *** ## The Study Workspace A study opens as one screen: the agent on the left, the map in the middle with its toolbar, and the right panel for everything the study contains. If you last selected a pin, shape, site, or deal in the study within the past 48 hours, reopening it resumes on that selection and the map focuses on it. ### The Agent The **GrowthFactor Agent** sits in a panel beside the map and acts on the study as you talk to it. It isn't available in a read-only or archived study. See [GrowthFactor Agent](/study/growthfactor-agent.md). ### The Toolbar Drawing tools are grouped behind two menus, **Pins** and **Shapes**, with annotation and history controls alongside them. A hint below the toolbar tells you what to click next once a tool is active. See [Controls & Shortcuts](/study/controls-and-shortcuts.md) for the shortcut list, and [Pins](/study/pins.md) and [Shapes](/study/shapes.md) for what each tool produces. ### The Study Panel The **Study** tab shows the study name, counts of pins, trade zones, and shapes, then up to three sections: **Pins** (add button **Add pin**, empty hint **No pins yet — click + to drop one.**), **Deals & Stores** (the deals and portfolio stores this scenario's trade zones are anchored to, including any pins promoted to a deal — hidden when there are none), and **Shapes & Boundaries** (add button **Extract boundary**). Hover any row for a trash icon to delete it without opening it. Select a pin, shape, site, or deal and the tab becomes **Pin**, **Shape**, **Site**, or **Deal** and shows that entity's details and analysis. Click **Study** again to return to the study overview — its tooltip reads **Back to study overview** while a detail view is open. Drag the panel's left edge to resize it, or use **Collapse panel** to get the full map back. Next to **Collapse panel** is a badge with the study's workspace, colored to match the workspace's assigned color, with a **View only** tag if you only have viewer access there. ### The Layers Panel The **Layers** tab controls what's drawn on the map — built-in data layers, your own custom layers, annotations, and the basemap. See [Data & Layers in a Study](#data-and-layers-in-a-study) below. *** ## Data & Layers in a Study ### Data Layers The **Layers** tab lists every built-in layer under **Data**: **Vehicle Traffic**, **Foot Traffic POIs**, **Tracked POIs**, **Zoning**, **My Stores**, **Deal Stages**, and, for accounts in the closed beta, [**Available Listings**](/data-and-analytics/available-listings.md). Click a row to toggle its visibility. Click **Show all** or **Hide all** in the section header to toggle every data layer at once. New studies start with **Tracked POIs** hidden until you turn it on. Rows for **Tracked POIs** and **Available Listings** have an arrow that opens that layer's settings as its own page in the panel. Use the back arrow to return to the layers list. ### Custom Layers A **Custom** section sits below the data layers. It holds one **Custom Layers** row for all the layers your workspace has imported or created. The row shows how many are on, such as **2 of 5 shown**. Click the eye to show or hide all of them, or click the arrow (**View custom layers**) to open the full list. In the list, search by name and toggle each custom layer on its own. Custom layers start hidden. Showing or hiding one only changes your view of the study. The underlying layer stays in the workspace. See [Map Layers](/manage/map-layers.md). ### Tracked Businesses Click the arrow on **Tracked POIs** to open its page and see which brands and categories the study is tracking. The header tells you whether you're **Using workspace defaults** or **Custom for you**. Defaults come from workspace settings. Any brands or categories you add yourself are visible only to you, and they stay in place until you reset. Use **Reset to defaults** to go back to the workspace set. While you're on workspace defaults, **Refresh defaults** pulls in the latest workspace settings. Admins can push a custom set to the whole workspace with **Save as defaults**, or jump to [workspace settings](/getting-started/workspace-settings.md) with **Edit Defaults**. For more on tracked brands and categories, see [Points of Interest](/data-and-analytics/points-of-interest.md). {% hint style="warning" %} Which layers you show is remembered in your browser, not saved to the study. A teammate opening the same study sees the default layers, and you'll see the defaults again if you open the study in a different browser. {% endhint %} *** ## Finding and Organizing Your Studies The **Studies** page lists every study you can see, with when it was last edited and by whom, and whether it's **Shared** or **Private**. Use **Search studies** to filter by name. ### Starring Use **Star** in a study's **⋯** menu, or the star icon in the study header. Starred studies appear in the **Starred** section of the sidebar, above **Recents**, and in the **Starred** list on [Home](/getting-started/home.md). Stars are yours alone — teammates don't see them — and they don't change the order of the studies list. **Unstar** removes it again. ### Sorting Click **Filter** and pick a **Sort by** option: **Recently edited** (the default), **Least recently edited**, or **Alphabetical**. Your choice is remembered the next time you open the page. ### Filtering by View The toggle above the list switches between **All**, **Private**, **Shared**, and **Archived**. If you have access to more than one workspace, **Filter** also lets you narrow the list to specific workspaces. *** ## Archiving a Study Choose **Archive** from a study's **⋯** menu and confirm. Archived studies are hidden from **Recents** and the main list, and move to the **Archived** tab — open one and it's read-only, with the agent hidden. **Unarchive** brings it back. Archiving is how studies are removed; there is no permanent delete. *** ## Asking the Agent Anything you can do by hand in a study, you can usually ask for instead. For example: * "Drop a pin at 4th and Main, Boston" * "What are the demographics of S1?" * "Merge S1 and S2 into one shape" * "What brands are inside S1?" See [GrowthFactor Agent](/study/growthfactor-agent.md) for how the agent works and what else it can do. The agent isn't available in archived studies. --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.growthfactor.ai/study/overview.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.