Manage Web Content

Use the options detailed in this topic to edit item descriptions or perform actions like moving or renaming items on your Tableau site. The options available to you are based on your site role and permissions.

Note: If Tableau Catalog is enabled on your site, you can add descriptions to fields on a published data source page. You can also access external assets (databases and tables). Some of the options for external assets differ from the options for Tableau content (project, workbooks, views, data sources, data roles, and flows).

Starting in 2019.3, Tableau Catalog is available in the Data Management to Tableau Server and Tableau Cloud. For more information, see "About Tableau Catalog" in the Tableau Server or Tableau Cloud Help.

Access options

The top of the page for each item displays the name of the item and the owner or contact. Some pages might show additional information, such as a description of the item or the date the item was last modified.

Content options

You can use the icons next to the item name to:

Add or edit descriptions

Descriptions make it easier for everyone in your organization to find the right items. If you own an item or have the appropriate permissions, you can edit the item’s description.

Describe projects, workbooks, and data sources

  1. From the navigation pane, select Explore.
  2. Navigate to the project, workbook, or data source you want to describe.
  3. Click the details icon i icon.
  4. To the right of About, click Edit.
  5. Enter a description in the About field. You can format the text in a message with bold, underline, and italics, and include a link or an image. To see text formatting tips, click Show formatting hints under the text box.
  6. Click Save.

Project Description

Describe metrics, data roles, Ask Data lenses, and collections

  1. From the navigation pane, select Explore.

  2. Navigate to the content you want to describe.

  3. For metrics and data roles, mouse over the Description header and click anywhere on the gray background that appears. (The legacy Metrics feature was retired in February 2024 for Tableau Cloud and will be retired in Tableau Server version 2024.2. For more information, see Create and Troubleshoot Metrics (Retired).)

    Metric description

    For lenses and collections, mouse over the description text and click anywhere on the gray background appears.

    Collection description

  4. Enter a description, then click Save.

Describe flows

  1. From the navigation pane, select Explore.
  2. Select All Flows from the drop-down menu.
  3. In the Name column, select the flow you want to describe.
  4. On the Overview tab, click the edit icon next to Description.
  5. Enter a description. You can format the text in a message with bold, underline, and italics, and include a link or an image. To see text formatting tips, click Show formatting hints under the text box.
  6. Click Save.

Flow Description

Describe databases and tables (available if Tableau Catalog is enabled)

  1. From the navigation pane, select External Assets.
  2. Select Databases and Files or Tables and Objects.
  3. In the Name column, select the asset you want to describe.
  4. From the Actions () drop-down menu to the right of the asset name, select Edit Description.

    How you can open the Edit Description dialog box

  5. In the About field of the Edit Description dialog box, enter a description. You can format the text in a message with bold, underline, and italics, and include a link or an image. To see text formatting tips, click Formatting Guide under the text box.
  6. Click Save.

When you add the description, there might be a delay before you can see your change.

Describe table columns (available if Tableau Catalog is enabled)

  1. From the navigation pane, select External Assets.
  2. Select Databases and Files or Tables and Objects.
  3. From the list, select the name of the asset with the column you want to describe.
  4. On the table page, under Columns, select the name of the column.
  5. In the Column Details dialog box, select the edit icon to the right of Description.

    How you can open the column description dialog box

  6. Enter a description in the Description field. You can format the text in a message with bold, underline, and italics, and include a link or an image. To see text formatting tips, click Formatting Guide under the text box.
  7. Click Save.

When you add the description, there might be a delay before you can see your change. After the description has been applied, you can see it in the Description column on the table page Lineage tab.

Describe fields in a published data source (available if Tableau Catalog is enabled)

  1. From the navigation pane, select Explore.
  2. Select All Data Sources from the drop-down menu.
  3. Click the data source name to open the data source page.
  4. On the Lineage tab, select the field you want to describe.
  5. In the Field Details dialog box, select the edit icon to the right of Description.
  6. Enter a description in the Description field. You can format the text in a message with bold, underline, and italics, and include a link or an image. To see text formatting tips, click Formatting Guide under the text box.
  7. Click Save.

An example of entering a Field Description

When you add the description, there might be a delay before you can see your change. After the description has been applied, you can see it in the Description column on the data source page Lineage tab. When you build a visualization, you can see the description on the Data tab by hovering your mouse over the field name.

How field descriptions are inherited (if Tableau Catalog is enabled)

When a description exists upstream from a field that has no local description, that field inherits the nearest upstream description. Information about where the description is inherited from also appears.

In web authoring on Tableau Server or Tableau Cloud, inherited descriptions always appear. In Tableau Desktop, inherited descriptions appear only when you’re connected to Tableau Server or Tableau Cloud.

Note: Inherited descriptions do not appear when using virtual connections in Tableau Desktop or web authoring.

An example of description inheritance in Tableau Desktop and Web Authoring

On Tableau Server and Tableau Cloud, inherited descriptions also appear in lineage pages and data details panes.

An example of description inheritance in Lineage pages

An example of description inheritance in the Data Details pane

Inherited descriptions have the following caveats. They:

  • Don't appear for calculated fields.
  • Aren't supported if your data source or workbook has more than 500 fields.
  • Aren't supported if your data source or workbook is so large that the inheritance query times out.

Access your content

To see the content you own, click your profile image or initials at the top of the page, and then click My Content.

Your options

Your content page displays your user information and the content that you own. From this page, you can also access your alerts, subscriptions, and account settings. To learn more, see Manage Your Account Settings.

Your content page

For the views you own, you can see which users have looked at a particular view by selecting Who Has Seen This View?.

Picture of Who Has Seen This View? selected in actions menu

Perform actions

Click check boxes to select items, then click the Actions drop-down menu to access commands available for those items.

If you don't have permission to perform an action on the item selected, the action will be disabled. If you select multiple items, and you don't have permission to perform an action on one of the items selected, you will get an error when you try to perform the action on that item.

Actions menu

Note: Different types of items have different actions available. If you select more than one type, for example, selecting a workbook and a data source, the actions you see will be limited to those in common between the types.

Access the actions menu for the item you currently have open by clicking the at the top of the page. This actions menu is disabled if you have check boxes selected for other items on the page; instead, use the actions menu shown above to modify checked items.

Accessing action for content currently open

In grid view, access the actions menu from the lower-right corner of a thumbnail.

Accessing actions from thumbnail

In list view, access the actions menu to the right of the item’s name.

Accessing actions from list

Delete content

In order to delete content, you must meet one of the following criteria:

  • Have a site role of Explorer (can publish) or Creator AND have the Delete capability for the content
  • Be the content owner
  • If the item is in a project and not in Personal Space: Be the project owner or project leader where the content is located.

For more information about how permissions and site roles interact, see Effective Permissions.

Tip: Be careful when deleting content from your site. Deleting is a permanent action for all types of content except for views.

To delete content:

  1. From the navigation pane, select Explore.
  2. Navigate to the content you want to delete.
  3. From the Actions () drop-down menu, select Delete.

Some areas of your site, like collections, recommendations, and external assets, provide links or references to items. These links or references do not affect the items themselves. You can remove an item from a collection or hide a recommendation without worrying about deleting the original item.

Consequences of deleting content

Type of content Consequence
Workbooks, metrics, flows, and data roles The content is permanently deleted. You can't undo this action.
Views The view is removed from the site; however, it is still accessible if you edit or download the workbook. The effect is the same as if the view had been hidden upon publishing. For more information, see Show or hide sheets .
Projects

The project, and any Tableau content inside the project, is permanently deleted.

External assets are moved to the External Assets Default Project. (In Tableau Server 2022.3 and earlier, external assets are irrelevant since they can't be in a folder to begin with.)

Collections The collection is permanently deleted, but the items added to the collection are not deleted.
Thanks for your feedback!Your feedback has been successfully submitted. Thank you!