Documentation and naming conventions in Tableau - Step-by-Step Guide

Introduction

Good documentation and clear naming in Tableau help everyone understand your dashboards and reports. This makes it easier to update, share, and use your work without confusion.

When you create a new Tableau workbook that others will use or edit.

When you build complex dashboards with many sheets and filters.

When you want to make your work easy to understand after some time has passed.

When you share Tableau files with teammates or clients.

When you prepare reports that need regular updates or maintenance.

Steps

Step 1: Click

- Data pane

See all data sources listed with their current names

💡 Use clear, descriptive names for data sources to avoid confusion

Step 2: Right-click

- Any worksheet tab

Open context menu with options including Rename

💡 Rename worksheets with meaningful names that describe their content

Step 3: Select

- Worksheet tab > Rename

Worksheet name becomes editable

💡 Use names like 'Sales by Region' instead of 'Sheet1'

Step 4: Click

- Dashboard tab

Dashboard opens for editing

💡 Rename dashboards with clear titles that explain their purpose

Step 5: Click

- Dashboard > Description (in the Dashboard pane)

Description box appears where you can type notes

💡 Add notes about the dashboard’s purpose, data sources, and filters

Step 6: Click

- Data Source tab

Open data source view

💡 Add comments or descriptions to calculated fields and parameters

Step 7: Click

- Calculated field > Edit

Open calculation editor

💡 Use clear names and add comments inside calculations if possible

Before vs After

Before

Worksheets named Sheet1, Sheet2; data sources named DataSource1; no descriptions on dashboards

After

Worksheets named 'Monthly Sales', 'Customer Segments'; data sources named 'Sales DB 2024'; dashboards have descriptions explaining their purpose

Settings Reference

Worksheet Rename

📍 Worksheet tab > Right-click > Rename

Give worksheets meaningful names to describe their content

Default: Sheet1, Sheet2, etc.

Dashboard Description

📍 Dashboard pane > Description box

Add notes explaining the dashboard’s purpose and details

Default: Empty

Data Source Rename

📍 Data pane > Right-click data source > Rename

Rename data sources for clarity and easier identification

Default: Original data source name

Calculated Field Naming

📍 Data pane > Right-click calculated field > Rename

Use descriptive names for calculated fields to explain their use

Default: Calculated Field 1, 2, etc.

Common Mistakes

Leaving default names like Sheet1 or DataSource1

It makes it hard to understand what each sheet or data source contains

Rename sheets and data sources with clear, descriptive names

Not adding descriptions to dashboards

Users may not know the dashboard’s purpose or how to use it

Use the dashboard description box to add helpful notes

Using vague names for calculated fields

It is difficult to know what the calculation does without opening it

Name calculated fields clearly and add comments if possible

Summary

Use clear, descriptive names for worksheets, dashboards, data sources, and calculated fields.

Add descriptions to dashboards to explain their purpose and usage.

Good naming and documentation make your Tableau work easier to understand and maintain.