> 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/picturethis/getting-started/getting-started.md).

# Getting started

PictureThis can be used as a Dashboard Extension or as a Viz Extension. Although the extension's functionalities remain the same, the way they are configured slightly differs.&#x20;

## Dashboard Extension

A quick tip before you start: In general when you are working with Extensions, it is Best Practice to create a dedicated “datasheet” for your extension. This allows your general dashboard actions to interact with this datasheet and your Extension will dynamically respond to that.&#x20;

The first you must do to configure your extension is select the datasheet that holds the columns that you want to use in PictureThis. In your preparations, it is important to first add the datasheet to your dashboard before configuring the extension, follow our [BLOG](https://appsfortableau.infotopics.com/educational/tableau-tip-using-datasheets-to-supply-data-to-extensions/) for the best ways of setting up your data. Now in the configuration screen select the worksheet you want to retrieve data from. This worksheet will be the input for PictureThis. You can always add extra fields to this datasheet and open the configure screen again to use them in your PictureThis extension (labels, colors, links, etc.).

## Viz Extension

With Viz Extensions, it is easier to set up PictureThis. In an empty worksheet, use the marks pane's dropdown to find the 'Add Extensions' button. Upon clicking that, you can either use the free version of PictureThis from the Tableau Exchange or upload a .trex file. Once the extension has loaded, you can drag and drop columns into the Image marks card or the Data marks card to view the visual.&#x20;

<figure><img src="https://206363522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwiROQsuR1aGKNjfajOv6%2Fuploads%2FmPv2bZeLMH9pMQmxagZ9%2FCleanShot%202024-07-30%20at%2014.55.33%402x.png?alt=media&amp;token=c5955875-d4dd-4344-95c1-e30f1895cf70" alt=""><figcaption></figcaption></figure>

Keep in mind, that to use Viz Extensions, you need to use Tableau Cloud or Tableau Desktop/Server 2024.2 or later.<br>


---

# 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/picturethis/getting-started/getting-started.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.
