> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/files-and-tables/tableau/best-practices.md).

# Best Practices

## Recommended setup

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Test with a simple view first</strong></td><td>Before connecting complex multi-sheet dashboards, start with a single-sheet Tableau view to confirm the connection works. Once it does, you can scale to more views.</td></tr><tr><td><strong>Verify view permissions</strong></td><td>Confirm you have Viewer access to the Tableau view before creating the data flow. Open the view directly in Tableau to ensure it loads without permission errors.</td></tr><tr><td><strong>Check your view for filters</strong></td><td>If your Tableau view has filters applied, they'll be included in the export. Ensure these filters match what you want to export to your destination.</td></tr><tr><td><strong>Use Append for multiple Tableau sources</strong></td><td>If you're exporting data from multiple Tableau views (e.g., different regions or time periods), create separate data flows and use Append in Coupler.io to combine them into a single table.</td></tr></tbody></table>

## Data refresh and scheduling

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Start with manual runs</strong></td><td>Always run your data flow manually once before scheduling. This confirms the connection works and gives you a preview of the exported data.</td></tr><tr><td><strong>Schedule during off-peak Tableau usage</strong></td><td>If your Tableau instance is shared with many users, schedule exports during early morning, late evening, or weekends to avoid rate limits and server load.</td></tr><tr><td><strong>Use daily or weekly refreshes for most cases</strong></td><td>Most Tableau dashboards update daily or weekly. Align your Coupler.io refresh schedule with your data pipeline — no need to export every hour if Tableau only updates once a day.</td></tr></tbody></table>

## Performance optimization

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Keep Tableau views lean</strong></td><td>The simpler your view structure, the faster the export. If a view exports slowly, check Tableau for large data sources or slow calculations — optimize at the source.</td></tr><tr><td><strong>Watch out with multi-sheet dashboards</strong></td><td>Only the first alphabetical sheet exports. If you need multiple sheets, create separate Tableau views (one per sheet) and set up individual data flows, then Append them in Coupler.io.</td></tr></tbody></table>

## Common pitfalls

{% columns %}
{% column %}
**Do**

* Test the view URL by opening it in your browser first
* Use Viewer permissions as your baseline (higher permissions work too)
* Schedule exports at off-peak times if your Tableau Server is shared
* Double-check that the view you're exporting is the one you actually need
* Keep data flows simple — export one view per flow, combine with Append if needed
  {% endcolumn %}

{% column %}
**Don't**

* Copy-paste URLs from emails or Slack — always copy directly from the browser address bar
* Use private Tableau Server URLs without confirming IP whitelisting with support first
* Schedule multiple overlapping data flows to the same Tableau view (can trigger rate limits)
* Expect to export specific sheets from multi-sheet dashboards without renaming them first
* Assume filters visible in the Tableau UI will automatically apply to exports — check the view's actual filter state
  {% endcolumn %}
  {% endcolumns %}

{% hint style="danger" %}
**Never share your Tableau view URL with others** in Coupler.io settings. The URL may contain sensitive workspace or site information. If you need to troubleshoot, only share it directly with Coupler.io support.
{% endhint %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coupler.io/sources/category/files-and-tables/tableau/best-practices.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.