{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":35456,"path":"now-intelligence/dashboard-component-properties-setup.md","title":"Dashboard component properties","bundle":null,"doc_type":null,"release":"australia","body":"\n# Dashboard component properties\n\nDisable and enable dashboard component runtime user abilities with these properties.\n\n\n
\n\nField\n\n\n\nDescription\n\n
\n\nTab Sys Id \\[tabSysId\\]\n\n\n\nIf you want to display only one tab of an existing dashboard, specify its SysID. Also specify the dashboard in Default dashboard.You can select a dashboard statically or dynamically, through a state variable or a script.\n\n
\n\nUse default redirections \\[defaultDrilldowns\\]\n\n\n\nWhen activated, the inline editor adds default pre-configured redirections for when a segment of a data visualization is clicked. To implement a custom drilldown, set this property to false, then add and customize a Dashboard Widget Clicked event handler as described in the Events section. Default: true\n\n
\n\nDisable the whole header \\[hideHeader\\]\n\n\n\nViewers do not see the dashboard header, only the content.\n\n
\n\nHide dashboard picker \\[hideDashboardPicker\\]\n\n\n\nWhen true, hides the dashboard picker on all dashboards in the workspaceDefault: false\n\n
\n\nDisable sharing \\[hideShareButton\\]\n\n\n\nHides the Share button on all dashboards from all users, but applies only to the Dashboards page where this value is set.Default: false\n\n
\n\nDisable editing \\[hideEditButton\\]\n\n\n\nHides the Edit button on all dashboards from all users, but applies only to the Dashboards page where this value is set.Default: false\n\n
\n\nDisable dashboard creation \\[hideCreateNewButton\\]\n\n\n\nHides the Create Dashboard option in the 3-dot menu of the Dashboard page. Users can still create dashboards from the Analytics Center or the dashboards library \\(Dashboard Overview component\\).When false:\n\n \\[Omitted image \"hide-create-dashboard-false.png\"\\] Alt text: 3-dot menu of dashboards when Disable dashboard creation is off.\n\n When true:\n\n \\[Omitted image \"hide-create-dashboard-true.png\"\\] Alt text: 3-dot menu of dashboard page when Disable dashboard creation is on.\n\n Default: false\n\n
\n\nUse as embedded \\[useAsEmbedded\\]\n\n\n\nSet to true when you, as a developer, want to use the dashboard component inside your page in isolation from the page's URL parameters. Meaning, you want full control over what the dashboard renders, regardless of URL parameters. The Copy URL and Copy URL with filter options are not available on such embedded dashboards.Default: false\n\n
\n\nDelegate URL params \\[delegateUrlParams\\]\n\n\n\nAllows the UIB pages which contains the dashboard to take control of how the Dashboard component handles URL parameter updates. When enabled, instead of the dashboard directly updating the browser URL, it dispatches a DASHBOARD\\#URL\\_PARAMS\\_UPDATE\\_REQUESTED event containing the parameters that would have been updated. The parent page can then handle navigation using a client script.Set this property in these circumstances:\n\n- The page URL structure does not include dashboard URL parameters \\(for example, no sys-id in the URL path\\).\n- The page needs custom navigation logic for dashboard changes.\n- The dashboard is embedded \\(without isEmbedded turned on\\) in a workspace where URL management is handled by the parent.\n\nFor more information, see [Dashboard URL parameter delegation](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/now-intelligence/dashboard-url-parameter-delegation.md).\n\n**Note:** This functionality requires the latest Platform Analytics experience application from the ServiceNow® Store.\n\n
\n\nDefault dashboard \\[defaultDashboard\\]\n\n\n\nSelect an existing dashboard to show in this dashboard component. This other dashboard is usually in the Platform Analytics experience. For that dashboard to be shown, it must include your workspace or experience in the **Dashboard Visibility** field in its dashboard details, as described in [Configure Platform Analytics dashboard details](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/now-intelligence/config-db-in-ac.md).You can select a dashboard statically or dynamically, through a state variable or a script.\n\n
\n\nShareable Filter SysID \\[filterId\\]\n\n\n\nThe sysId of the persisted filter set up of a dashboard\n\n
\n\nGlobal filters \\[globalFilters\\]\n\n\n\nFilters for the visualizations within the dashboard. These filters apply to all relevant data visualizations. The format of the value passed to globalFilter is the stringified form of \\{encodedQueries: 'encoded-queries-string', filters: 'PAR-Filter'\\}. Both encodedQueries and filters are transformed into PAR filters internally and merged with existing filters in the dashboard.Either `encodedQueries`, `filters`, or both can be specified. In the following example, equivalent `encodedQueries` and `filters` values both filter visualizations that show records from the Incident \\[incident\\] table based on a State field value of 1 or 2:\n\n```\nJSON.stringify({\n encodedQueries: {incident: 'stateIN1,2'},\n parFilters: [{ order: 0, apply_to: ['incident.state'], values: ['1', '2'] }]\n})\n```\n\n
\n\nDrilldown to Core UI \\[drilldownToCoreUI\\]\n\n\n\nToggle on for drill down on table data sources to redirect to the Core UI list of table records. When off, drilling down opens a Simple List component of the table records, if the workspace contains a simple list.Does not apply to technical dashboards. Data visualizations on technical dashboards have to have their Visualization Clicked event handlers configured for drilldowns.\n\nDefault: off\n\n
\n\nUse data broker to fetch data \\[useDataBroker\\]\n\n\n\nWhen toggled on, the dashboard prefetches static JavaScript, such as dashboard metadata, using a data broker. The Dashboard data broker preset automatically toggles this property on. Without the preset, this property is off by default. For more information, see [Configure dashboard data broker](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/now-intelligence/configure-dashboard-data-broker.md).\n\n
\n\nData broker response for the dashboard \\[data\\]\n\n\n\nThe response for the data broker when it is used. The Dashboard data broker preset automatically sets a JSON object for this property. You can override this value or set it manually without turning the preset on, if you absolutely need to.\n\n
**Parent Topic:**[Add a dashboard to a Dashboards page](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/now-intelligence/add-dashboard-to-workspace.md)\n\n"}}