Customizing the Tanium Console and Interact

You can customize the appearance and behavior of the Tanium Console and Interact Home page.

Customize the Tanium Console color

In deployments with multiple Tanium Servers (such as lab servers, test servers, and production servers), customizing the background color of the Tanium Console header can help users identify which server they are signed into for the current session. The following figure shows an example of a custom color.

Figure  1:  Tanium Console header color

Users require the Administrator reserved role to manage the console color.

  1. Go to Configuration > Miscellaneous > User Configurations.
  2. In the Console Color section, use the Current Color selector to pick your custom color or click No Color .
  3. Click Save Change and confirm the operation when prompted.
  4. Wait about two minutes for the change to apply, and then refresh your web browser to confirm that the new color appears as expected.

    To apply the change immediately, restart the Tanium Server service: see Manage the Tanium Server service.

Select the Tanium Console header text

By default, the Tanium Console header displays only the logo on the left and non-configurable fields on the right. In deployments with multiple Tanium Servers (such as lab servers, test servers, and production servers), adding header text can help users identify which server they are signed into for the current console session. The following figure shows an example that identifies a production server:

Figure  2:  Tanium Console header text

Users require the Administrator reserved role to manage the header text.

Perform the following steps to add, edit, or remove the console header text:

  1. Go to Configuration > Miscellaneous > User Configurations.
  2. In the Console Header Text section, enter the new text in the Change Header Text field.

    If you want to revert to the default (no text), click Reset.

  3. Click Save Change and confirm the operation when prompted.
  4. Wait about two minutes for the change to apply, and then refresh your web browser to confirm that the text appears as expected.

    To apply the change immediately, restart the Tanium Server service: see Manage the Tanium Server service.

Select the confirmation prompt for Tanium Console tasks

Many tasks that users initiate in the Tanium Console require responding to a confirmation prompt before the tasks proceed. Select the prompt type based on whether you want to optimize Tanium Console security (password prompt) or the user experience (yes/cancel prompt).

Only users assigned the Administrator reserved role can manage the confirmation prompt.

If you enable Security Assertion Markup Language (SAML) single sign-on, the Tanium Server automatically changes the prompt to a Yes/Cancel prompt. For details, see Integrating with a SAML IdP.

  1. Go to Configuration > Miscellaneous > Confirmation Prompt.
  2. Select Show a password prompt or Show a Yes/Cancel prompt.
  3. Save your changes.

Customize the Tanium Console help URL

By default, clicking the Help link at the top right of the Tanium Console opens a new browser tab or window with the URL https://docs.tanium.com. In deployments where that URL is inaccessible (for example, if the Tanium Server does not have Internet access), you can change the help URL.

Figure  3:  Tanium Console Help link

Users require the Administrator reserved role to manage the console help URL.

  1. Go to Configuration > Miscellaneous > User Configurations.
  2. In the Help URL section, enter the new URL in the Change URL field.

    If you want to revert to the original, default help URL, click Reset.

  3. Click Save Change, wait about two minutes for the change to apply, and refresh your web browser.

    To apply the change immediately, restart the Tanium Server service: see Manage the Tanium Server service.

  4. Click the Help link to verify that it opens the new URL.

Customize the Tanium Console logo

You can replace the default Tanium logo in the header of the Tanium Console with the logo of your organization. Use the Tanium logo file as a guide to image size. The Tanium Console supports all the standard image formats that your browser supports, such as PNG, JPG, and SVG. The maximum file size is 2 MB. The Tanium Console automatically resizes the file to 27 pixels high and scales the width proportionately.

Figure  4:  Tanium Console logo

Users require the Administrator reserved role to manage the console logo.

  1. Create your own logo file.
  2. Go to Configuration > Miscellaneous > User Configurations.
  3. In the Console Logo section, click Choose File, select the logo file, and click Open.

    If you want to revert to the original, default logo, click Reset.

  4. Click Save Change.
  5. Wait about two minutes for the change to apply, and then refresh your web browser to confirm the new logo appears as expected.

    To apply the change immediately, restart the Tanium Server service: see Manage the Tanium Server service.

Set Tanium Console user preferences

User preferences control certain behaviors of the Tanium Console on a per-user basis. Changes that you make to your settings affect all the personas that are assigned to your account, but do not affect other users. The Tanium Server applies the preferences of a user when that user logs into the console. The Tanium Console filters the settings on the Edit Preferences page based on the effective permissions of the persona used to access the page. For example, if the persona does not have permission to ask questions, many of the settings do not appear. For details on permissions, see RBAC overview.

  1. Click the drop-down list beside <username> <persona> at the top right of the Tanium Console and select Preferences.
  2. Configure the settings described in Table 1 and click Save. The changes apply immediately.
Table 1:   User preferences
Settings Guidelines
Consider question results complete at The default is 99%.
Number of answer rows to load per request The default is 100.
Suspend console automatically if no activity detected for The default is 10 minutes. The value must be equal to or less than the timeout that your administrator set for all users through the max_console_idle_seconds setting (Administration > Global Settings). The global setting has a default of 3,600 seconds (1 hour). If you set the user preference to a lower value than the global setting, the Tanium Server applies the user preference.
Submit filter text after After the user starts typing in a filter field in the Tanium Console, the Tanium Server does not start searching for the text string until the specified time period passes. The default is 700 ms.
Hide error results from questions Enabled by default. Select this option if you want the Questions Results grid to omit null or error values, such as [no results] or [results currently unavailable]. This option provides clarity in that the grid shows only the answers that are likely to be useful. However, this option also prevents the grid from showing the complete set of answers received from all endpoints.
Hide duplicate columns in result grid Not enabled by default. By default, the Question Results grid shows columns of the same name when a question has multiple sensors that use the same column name.
Copy/Export with headers by default Enabled by default. Select this option to include the grid header row when you copy or export grid rows. You can override this setting when you perform an export operation.
Enable multiple column sorting Select this option to enabling sorting by multiple columns in the Question Results grid. By default, this option is disabled and you can sort only by one column.
Language Select a language for text that appears in the Tanium Console. The Default is the language selected for the browser that you use to access the Tanium Console.

Customize Tanium module home pages

Each Tanium module, including Interact, has a Home page that appears when you navigate to the module or click the Home page link from a page within the module workbench. The module Home pages have sections that might include guidance on getting started, reports related to module health, or reports related to deployment metrics. Perform the following steps if you want to show, hide, or reorder sections of a module Home page. Your changes apply across all the personas that are assigned to your user account.

  1. Click the Manage Home Page link at the top right of the module Home page to open the Home Page Management dialog.
  2. Select (show) and deselect (hide) the sections as desired.

    You can also hide a section directly in the Home page by hovering over a section header and clicking x.

  3. Drag-and-drop the sections to reorder them.


The Interact Home page displays categories, dashboards, and saved questions that you selected as favorites. To change the content that appears on this page, see Filter by favorites.