> For the complete documentation index, see [llms.txt](https://docs.infotopics.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infotopics.com/features/tableau-extension/configuration.md).

# Configuration

Everything about how the extension behaves in your dashboard is set in the configuration dialog: which schemas it writes to, how the form looks, when data is refreshed and who may change what. This section walks through every screen in it.

### Open the configuration

<figure><img src="https://3247237607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0gkOLIfzuEyMP2kvoT9o%2Fuploads%2Fgit-blob-87cae228e4680b0dfc5282bc34195930d1e3d692%2FWBE634_Ext_Config_CogOverlay.png?alt=media" alt=""><figcaption><p>The cog overlay in the extension</p></figcaption></figure>

The configuration is only available while you are editing the dashboard in Tableau. There are two ways in:

* Tableau's own extension menu, via **Configure...**
* The cog icon in the extension header, which opens an overlay with **Configure Extension**, **Open Management Console** and **Cancel**.

Both open the same dialog. Your users never see the cog — it only appears in authoring mode, and the configuration cannot be saved outside it.

The first time round there is nothing to configure yet, and the extension shows **It's time to add your first schema!** with a **Start configuring** button.

### How the dialog is laid out

<figure><img src="https://3247237607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0gkOLIfzuEyMP2kvoT9o%2Fuploads%2Fgit-blob-273c77a1a661e9119f95dcf3c3325fc449d235ea%2FWBE634_Ext_Config_Dialog.png?alt=media" alt=""><figcaption><p>The configuration dialog, on General › Schemas</p></figcaption></figure>

Three tabs across the top:

| Tab                  | What it covers                                                                                                                                 |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **General**          | Settings for the extension as a whole: which schemas are connected, authentication, popup behaviour, theming, tabs, mapping and import/export. |
| **Worksheet-schema** | Settings per connected schema: the General tab, Field formatting and Form builder.                                                             |
| **Changelog**        | What changed in which version, plus support and documentation links.                                                                           |

Start with [General](https://docs.infotopics.com/features/tableau-extension/configuration/general.md) to connect a schema, then open [Worksheet-schema](https://docs.infotopics.com/features/tableau-extension/configuration/schemas.md) to configure each one.

### Save and refresh

Nothing you change is stored until you press **Save** in the toolbar. While there are unsaved changes the button carries a blue dot, and the dialog keeps a floating message in view: **You need to save the changes before closing the dialog!**

**Refresh** pulls the latest settings from the back end, which is what you need after a schema was changed in the management console.

| Shortcut           | Action           |
| ------------------ | ---------------- |
| `Ctrl`/`Cmd` + `S` | Save             |
| `Ctrl`/`Cmd` + `R` | Refresh          |
| `Ctrl`/`Cmd` + `W` | Close the dialog |

{% hint style="warning" %}
Close the dialog without saving and your changes are gone. Tableau treats the extension's settings as part of the workbook, so remember to save the workbook itself as well.
{% endhint %}

### Where to start

1. Connect a schema to a worksheet under **General** > **Schemas**.
2. Set up how records are created and refreshed under **Worksheet-schema** > **General**.
3. Shape the form and the overview under **Field formatting** and **Form builder**.
4. Match the extension to your dashboard under **General** > **Theming**.


---

# 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.infotopics.com/features/tableau-extension/configuration.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.
