> For the complete documentation index, see [llms.txt](https://help.felt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.felt.com/getting-started/create-your-first-map.md). # Create your first map Make your first Felt map in minutes: add data, style it, and share it, with Felt AI or on your own. Build a map with Felt AI: ask it to add data, style the result, and explain its work. Each step shows what to ask and links to the manual steps when you'd rather do it yourself. ## Step 1: Create a map Create a map for Felt AI to work on. Felt saves your changes automatically. 1. Go to [felt.com](https://felt.com) and log in. If you don't have an account, see [Account and login](/getting-started/account-and-login.md). 2. Click **New map** (**+**) next to **Maps** in the sidebar, or **New map** on **Recent maps**, **Drafts**, or a project page. The new map opens. 3. Optional: Click the map's name at the top left and enter a new name. You can also go to [felt.com/map/new](https://felt.com/map/new) to create a map in one step. ## Step 2: Add data Ask Felt AI to add a county layer to your new map. A new map opens in edit mode, with **Done** at the top right, so you can change it right away. 1. If you see **Edit map** instead of **Done**, click **Edit map** to enter edit mode. 2. Click **Felt AI** in the toolbar at the top right of the map. 3. Enter "Add US county boundaries to this map. Explain what you do as you go" and press **Enter**. Felt AI adds the counties as a layer in the legend. You can ask "What is a layer?" or "How do I see the data behind these counties?" to learn as you build. See [AI assistant](/felt-ai/ai-assistant.md). To use your own file, [upload your data](#upload-your-own-data) first; Felt AI can't accept files in chat. You can also [add Global Library layers](#add-global-library-layers) yourself. ## Step 3: Style the data Ask Felt AI to color the counties by population: > Color the counties by population and explain how the colors work. Check the colors and values on the map. To refine the result, ask "Use a blue color palette" or "How do I change these colors myself?" For the manual steps, see [Style data yourself](#style-data-yourself). ## Step 4: Share the map Share your map with View, Contribute, or Edit access. People who only view and comment don't need a seat. 1. Click **Share** at the top right of the map. 2. Enter each person's email address and select their access level. 3. Click **Invite**. Each person gets an email with a link to the map. 4. Optional: To let anyone with the link view the map, set public link access to **View**, then click **Copy link**. New maps start in your **Drafts** unless you create them inside a project. Click **Share** to check who can open the map. See [Organize maps](/maps/organize-maps.md). To show the map on a website, [embed it](/share/embed-a-map.md). For more sharing options, see [Share a map](/share/share-a-map.md). {% embed url="" %} ## Add data yourself Felt organizes map data into layers. On any plan, you can start with ready-made Global Library layers or [draw on the map](/annotations/draw-on-the-map.md) with pins, lines, and shapes. {% hint style="info" %} To follow along, use your own data or this [demo dataset of store revenue across the US](https://docs.google.com/spreadsheets/d/1EQUL2YO8efOjONfFYIVO1Y3W6HgzYJF58u0kDsW0CHw/edit?gid=0#gid=0). {% endhint %} {% embed url="" %} ### Add Global Library layers The Global Library has ready-made layers of boundaries, demographics, land cover, and imagery. Click **Data sources** in the toolbar, open **Global Library**, and select a layer. See [Global Library](/upload-anything/global-library.md). Once a layer is on the map, double-click it in the legend to zoom to it, or click **Open table** to see its data. See [Table](/tools/table.md). ### Upload your own data Upload a file to map your own data. Felt places the data on the map and converts addresses in spreadsheets to points. 1. In the toolbar, click **Upload Anything**. 2. Click **Upload file** and select the file. You can also drag the file onto the map. The layer appears in the legend when it's ready. To add data from a link, such as a Google Sheet, click **Upload Anything** > **From URL** instead. See [Upload files](/upload-anything/files.md) and [Supported file types](/upload-anything/files/supported-file-types.md). ## Style data yourself Style a layer's colors, sizes, and labels in the **Style** tab of the detail panel. 1. Click the layer in the [legend](/layers/legend.md). If the layer is in a group, open the group and click the layer. The detail panel opens on the right with the **Style** tab selected. 2. In the **General** section, select a visualization type, such as **Simple**, **Categories**, or **Color range**. The other options depend on the visualization type. 3. Select the attribute to style by and adjust the colors. 4. Optional: In the **Popup** section, choose what people see when they click a feature. See [Style vector layers](/styling/style-vector-layers.md), [Labels](/styling/labels.md), and [Popups](/styling/popups.md). {% embed url="" %} ## Watch a walkthrough {% embed url="" %} --- # 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://help.felt.com/getting-started/create-your-first-map.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.