> 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/upload-anything/qgis-plugin.md).

# QGIS plugin

Use the Add to Felt plugin for QGIS to send layers and styles to a new or existing Felt map.

Use the Add to Felt plugin to send QGIS layers and their styles to a Felt map you can share on the web.

The plugin works with QGIS 3.22 and later, including QGIS 4.

{% embed url="<https://youtu.be/-mUdqQ4FX6E?si=S_zCxEb64oP1QORj>" %}

## Install the plugin

The plugin is in the QGIS plugin repository as [Add to Felt](https://plugins.qgis.org/plugins/felt/).

1. In QGIS, open **Plugins** > **Manage and Install Plugins…**.
2. Search for **Add to Felt**.
3. Select **Add to Felt**, then click **Install Plugin**.

## Log in to Felt from QGIS

The plugin needs your permission to add maps to your Felt account.

1. In QGIS, open **Web** > **Felt** > **Sign In…**.
2. In the **Authorize Felt** dialog, click **Log In**. If you don't have a Felt account yet, click **Sign Up** instead.
3. Your browser opens Felt. Click **Authorize** to let QGIS act on your behalf.

To log out, open **Web** > **Felt** and click **Log Out**.

## Send a QGIS project to Felt

The plugin sends the visible layers in your QGIS project to a Felt map.

1. In QGIS, open **Web** > **Felt** > **Add to Felt…**.
2. Select the Felt workspace to add the map to.
3. Select **New map** and enter a title, or select an existing map to add the layers to.
4. Click **Add to Felt**. The dialog shows the upload's progress.
5. When the upload finishes, click **Open Map** to open the map in Felt.

## Send one layer to Felt

To send a single layer, right-click it in the QGIS **Layers** panel, then click **Export** > **Share Layer to Felt…**. The same dialog opens, with only that layer.

## What the plugin sends

The plugin supports these QGIS layers:

* Vector layers that have features and no unsaved edits
* Raster layers from files, and virtual rasters
* XYZ tile layers, except URLs that use a `{q}` quadkey

Other layer types, such as WMS layers and mesh layers, aren't sent. The dialog lists the layers it can't send before you start.

The plugin converts QGIS styles to Felt styles. Single-symbol, categorized, graduated, rule-based, and heatmap styles carry over, along with many label settings. A raster style that can't be converted is sent as a styled image, so it looks the same in Felt but can't be restyled there.

## Frequently asked questions

<details>

<summary>Can I upload a QGIS project file (.qgz or .qgs) to Felt directly?</summary>

No. Felt doesn't read QGIS project or style files, such as `.qgz`, `.qgs`, or `.qml`, and suggests the plugin when you upload one. Open the project in QGIS and send it with the plugin. See [Troubleshooting uploads](/upload-anything/files/troubleshooting-uploads.md).

</details>

<details>

<summary>Can the plugin publish layers to a Felt Server?</summary>

No. The plugin adds layers to a Felt map. From the map, you can publish them to a Felt Server to reuse them on other maps. See [Felt Servers](/upload-anything/felt-servers.md).

</details>

<details>

<summary>Why does the plugin say I don't have edit access for any workspaces?</summary>

The plugin can only add maps to a workspace where you can create maps, which needs a seat. Ask a workspace admin to give you a seat, or create your own workspace. See [Manage members](/administration/manage-members.md).

</details>


---

# 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/upload-anything/qgis-plugin.md?ask=<question>&goal=<user_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.