Export Tags

Required Tenable Vulnerability Management User Role: Scan Manager or Administrator

On the Tags page, you can export tag categories and values in CSV or JSON format.

To export tag categories or values:

  1. In the upper-left corner, click the Menu button.

    The left navigation plane appears.

  2. In the left navigation plane, click Settings.

    The Settings page appears.

  3. Click the Tagging tile.

    The Tags page appears. On this page, you can view your asset tag categories and values.

    The Categories tab is active.

  4. (Optional) Refine the table data. For more information, see Tenable Vulnerability Management Workbench Tables.

    Note: You cannot filter the tables on the Tags page.

  5. Do one of the following:

    1. Select the tag categories that you want to export:

      Export Scope Action
      Selected tag categories

      To export selected tag categories:

      1. In the categories table, select the check box for each tag category you want to export.

        The action bar appears at the top of the table.

      2. In the action bar, click Export.

        Note: The Export link is available for up to 200 selections. If you want to export more than 200 tag categories, select all the tag categories in the list and then click Export.
      A single tag category

      To export a single tag category:

      1. In the categories table, right-click the row for the tag category you want you want to export.

        The action options appear next to your cursor.

        -or-

        In the categories table, in the Actions column, click the button in the row for the tag category you want to export.

        The action buttons appear in the row.

      2. Click Export.

    1. Click the Values tab.

      The Values tab appears. This tab consists of a table that contains all your tag values.

    2. Select the tag values that you want to export:

      Export Scope Action
      Selected tag values

      To export selected tag values:

      1. In the values table, select the check box for each tag value you want to export.

        The action bar appears at the top of the table.

      2. In the action bar, click Export.

        Note: The Export link is available for up to 200 selections. If you want to export more than 200 tag values, select all the tag values in the list and then click Export.
      A single tag value

      To export a single tag value:

      1. In the categories table, right-click the row for the tag value you want you want to export.

        The action options appear next to your cursor.

        -or-

        In the values table, in the Actions column, click the button in the row for the tag value you want to export.

        The action buttons appear in the row.

      2. Click Export.

    The Export plane appears. This plane contains:

    • A text box to configure the export file name.
    • A list of available export formats.
    • A table of configuration options for fields to include in the exported file.

      • Note: By default, all fields are selected.

    • A text box to set the number of days before the export expires.
    • A toggle to configure the export schedule.
    • A toggle to configure the email notification.
  6. In the Name box, type a name for the export file.

  7. Click the export format you want to use:

    Format Description
    CSV

    A CSV text file that contains a list of tag categories or values.

    Note: If your .csv export file includes a cell that begins with any of the following characters (=, +, -, @), Tenable Vulnerability Management automatically inputs a single quote (') at the beginning of the cell. For more information, see the related knowledge base article.
    JSON

    A JSON file that contains a nested list of tag categories or values.

    Empty fields are not included in the JSON file.

  8. (Optional) Deselect any fields you do not want to appear in the export file.

  9. In the Expiration box, type the number of days before the export file expires.

    Note: Tenable Vulnerability Management allows you to set a maximum of 30 calender days for export expiration.

  10. (Optional) To set a schedule for your export to repeat:

    • Click the Schedule toggle.

      • The Schedule section appears.

    • In the Start Date and Time section, select the date and time on which you want the export schedule to start.
    • In the Time Zone drop-down box, select the time zone to which you want the schedule to adhere.
    • In the Repeat drop-down box, select how often you want the export to repeat.
    • In the Repeat Ends drop-down, select the date on which you want the schedule to end.

      Note: If you select never, the schedule repeats until you modify or delete the export schedule.

  11. (Optional) To send email notifications on completion of the export:

    Note: You can enable email notifications with or without scheduling exports.

    • Click the Email Notification toggle.

      The Email Notification section appears.

    • In the Add Recipients box, type the email addresses to which you want to send the export notification.

    • (Required) In the Password box, type a password for the export file. You must share this password with the recipients to allow them to download the file.

      Note: Tenable Vulnerability Management sends an email to the recipients and from the link in the email, the recipients can download the file by providing the correct password.

  12. Click Export.

    Tenable Vulnerability Management begins processing the export. Depending on the size of the exported data, Tenable Vulnerability Management may take several minutes to process the export.

    When processing completes, Tenable Vulnerability Management downloads the export file to your computer. Depending on your browser settings, your browser may notify you that the download is complete.

  13. Access the export file via your browser's downloads directory. If you close the export plane before the download finishes, then you can access your export file in the Export Management View.