# 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 %}