Use parameters to transform static widgets into versatile tools that adapt to various
project requirements. By using parameters to drive widget behavior, you can repurpose a single
visualization for different projects, regions, or time frames without rebuilding the underlying
logic.
Required Editions
| User Permissions
Needed |
| To edit Tableau Next dashboards: |
Tableau Unmetered Platform Analyst or Tableau Next Platform Analyst permission set |
-
Open the semantic model in your workspace.
-
Click New then select Parameter.
-
Enter a value for Parameter Name. API Name is automatically generated, but you can
define your own.
-
Select a data type. The data type and parameter type depends on how you show a
parameter on your dashboard. Review the table to ensure your parameter functions
correctly.
| Parameter Display |
Data Type |
Parameter Type |
|---|
| List |
Text, Number, Date, Boolean |
List |
| Toggle |
Text, Number, Date |
List |
| Input |
Text |
Single Value |
-
Select the parameter type.
-
Type in a default value.
-
Select the default display name if using a list widget.
-
Click Save.
- List Parameter Example
You’ve been asked to create sales visualizations with several groupings, such as Region and Segment. You're going to reuse the existing visualization that you can update as grouping requirements change.
- Model Hypothetical Scenarios by Using Parameter Inputs
Enter text, numbers, or dates into parameter widgets for lookup and modeling hypothetical scenarios. Dashboard calculations update instantly by using your custom values rather than just existing data.
- Navigate Dashboards with Parameter Actions
Parameter actions enable you to map visualization fields to parameters, transforming static charts into interactive navigation tools. This setup enables users to trigger dashboard updates by clicking data points, streamlining data exploration within a single interface.
Note Input is the default parameter display in the Show As widget property when a parameter is set for manual entry.