# Atoti Hub: Data visualization Atoti UI 5.2

## 5.2

### Introduction

- [Introduction to Atoti UI](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/introduction-to-atoti-ui.md): Atoti UI combines real-time financial analytics, self-service dashboards, pivot tables, and customizable visualizations with enterprise capabilities including authentication, entitlements, extensible plugins, and hybrid cloud or on-premises deployment.

### Releases and Upgrades

- [Release notes](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/releases-and-upgrades/release-notes.md)
- [Changelog](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/releases-and-upgrades/changelog.md)
- [Dependencies](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/releases-and-upgrades/dependencies.md)

#### Migration guide

- [5.1 to 5.2](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/releases-and-upgrades/migration-guide/5.1-to-5.2.md)
- [5.0 to 5.1](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/releases-and-upgrades/migration-guide/5.0-to-5.1.md)
- [4.3 to 5.0](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/releases-and-upgrades/migration-guide/4.3-to-5.0.md)

### User guide

- [Atoti UI user onboarding videos](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/video-tutorials/index.md): Index of Atoti UI user onboarding videos covering how to navigate and save work, build and edit dashboards, investigate data with filters, explore data using four techniques, and enhance widget display with the style tool.

#### Navigate Atoti UI

- [Home page](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/navigate-atoti-ui/home-page.md): What the Atoti UI home page provides for managing dashboards in list and grid views, including creating new dashboards, opening, moving, sharing, and deleting dashboards from the context menu, organizing them in folders, and searching via the navigation bar.
- [Data model](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/navigate-atoti-ui/data-model.md): Glossary and guide to the Atoti UI data model panel, defining cube, dimension, hierarchy, level, measure, and measure group, with instructions for resizing the panel and using the search bar and cube selector dropdown to filter available fields.
- [Settings](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/navigate-atoti-ui/settings.md): How to open the Settings popup from the user menu in Atoti UI, change a setting by toggling checkboxes or entering values, save the changes to apply them, and search within the popup using the search box, with the full list of options in the CoreSettings reference.
- [Keyboard shortcuts](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/navigate-atoti-ui/keyboard-shortcuts.md): Reference table of Atoti UI keyboard shortcuts for dashboard actions including save, undo, redo, and present mode, content management shortcuts for Saved widgets and Saved filters menus, table cell selection and renaming shortcuts, and the command palette toggle.
- [How to navigate and save your work](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/navigate-atoti-ui/navigate-video.md): Video tutorial showing how to navigate and save work in Atoti UI, demonstrating how to open the home page, switch between dashboards, manage pages, and save changes.

#### Create a dashboard

- [Dashboards](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/dashboards.md): What dashboards are in Atoti UI, covering how to create, rename, save, and navigate multi-page dashboards, use present mode, undo and redo changes, manage pages with unique layouts, filters, and widgets, and copy pages from one dashboard to another.
- [How to build, edit and save a dashboard](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/build-dashboard.md): Video tutorial showing how to build, edit, and save a dashboard in Atoti UI, demonstrating how to add widgets, arrange the layout, and save the dashboard configuration.
- [Share content](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/share-content.md): How to share dashboards, saved filters, and saved widgets in Atoti UI with named users or groups using the Share popup, assigning Reader or Editor access levels, with the canShare permission required to see sharing controls.
- [Import and export dashboards](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/import-and-export-dashboards.md): How to export and import dashboards and folders in Atoti UI as JSON files, covering single and bulk export from the home page context menu, importing into a folder or root, and use cases such as backup, sharing, and environment migration.

##### Widgets

- [About widgets](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/widgets/about-widgets.md): The Widgets panel in Atoti UI dashboards provides table widgets such as the Pivot table and the Database widget, KPI widgets, and Plotly charts for visualizing and exploring data in different ways.
- [Add or modify widgets](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/widgets/add-or-modify-widgets.md): How to add, rename, move, resize, duplicate, switch type, and remove widgets in Atoti UI dashboards, including dragging from the Widgets panel, moving widgets between dashboard pages, and replacing an existing widget by dropping a new one onto its center.
- [Add fields](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/widgets/add-fields.md): How to add hierarchies and measures to table, KPI, chart, and drillthrough widgets in Atoti UI using the Fields tab, including comparison KPI configuration, horizontal and vertical subplots, and multilevel hierarchy drill-down in pivot and tree table widgets.
- [Edit an MDX query](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/widgets/edit-an-mdx-query.md): How to use the Atoti UI Query tab to directly edit MDX for a selected widget, including autocomplete for measures, dimensions, hierarchies, and cube names, submitting or resetting changes, undoing edits, and resolving syntax and dimension errors.
- [Change a widget's cube](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/widgets/change-a-widgets-cube.md): How to change the cube a widget targets in Atoti UI using the cube selector dropdown, including identifying which server each cube is hosted on, and the constraint that switching is limited to cubes sharing the same hierarchies and measures already in use.
- [Save a widget](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/widgets/save-a-widget.md): How to save, reuse, rename, delete, update, and synchronize saved widgets in Atoti UI via the Saved widgets menu, covering the Save widget as workflow, how saved widgets behave as copies, and how to propagate updates to other instances using Synchronize saved widget.

###### Adapt widget display

- [Edit the style of a widget](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/widgets/adapt-widget-display/edit-the-style-of-a-widget.md): How to style widgets in Atoti UI using the Style tab, including showing, hiding and formatting the title bar of a widget, formatting numerical values per measure or for all measures at once, adding conditional and default styles for table cells and chart traces, table size and header wrap settings,…
- [Customize charts](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/widgets/adapt-widget-display/customize-charts.md): How to customize Plotly chart appearance in Atoti UI beyond the Style tab by adding a plotly attribute in the State tab, using the layout, data, and config properties to override legend position, marker mode, and the displayModeBar configuration option.
- [Rename row and column headers](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/widgets/adapt-widget-display/rename-row-and-column-headers.md): How to rename or restore the original name of row and column header cells in Pivot table, Tree table, and Table widgets in Atoti UI without changing the underlying member, measure, or cube data, and how to configure the edited-cells highlight that marks renamed cells.
- [How to enhance display with the style tool](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/widgets/adapt-widget-display/style-tool.md): Video tutorial showing how to enhance the display of Atoti UI widgets using the style tool, demonstrating conditional styles, chart color changes, and number formatting options in the Style tab.

##### Filters

- [About filters](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/filters/about-filters.md): What filters are in Atoti UI, covering the five filter scopes from default to widget level, how filter order affects query results, the canUseUserFilters permission for All dashboards filters, slicing hierarchy default members, and smart filtering behavior.
- [Add a filter](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/filters/add-a-filter.md): How to add filters in Atoti UI using the Filters popup with member selection, advanced filter configuration, type-or-paste input, date and date range pickers with rolling date and Month/Quarter/Year to date options, and Filter on member or Filter on selection from a widget's context menu.
- [Pin a filter](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/filters/pin-a-filter.md): How to pin and unpin filters in Atoti UI to display them in the Filters bar above a widget, page, or dashboard, enabling quick filter modification from the filters bar dropdown without opening the tools panel, including during Present mode.
- [Save a filter](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/filters/save-a-filter.md): How to save, manage, and reuse filters in Atoti UI using the Saved filters menu, including creating folders, adding saved filters to widgets by drag-and-drop or click, renaming, deleting, and sharing filters across your organization.
- [Apply filters in bulk](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/create-a-dashboard/filters/apply-filters-in-bulk.md): How to apply, switch, and pin filter folders in Atoti UI to add multiple saved filters at once to a dashboard, page, or widget, including the limitation that only folders without subfolders can be applied as a single tile.

#### Analyze data

- [Refresh dashboard data](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/analyze-data/refresh-dashboard-data.md): How to keep widget data current in Atoti UI using the Refresh context menu option, real-time mode toggled by the play/pause button, and Defer updates to pause all widgets during complex configuration changes.
- [Sort data](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/analyze-data/sort-data.md): How to sort tables and charts in Atoti UI by hierarchy or measure using the Sort ascendingly and Sort descendingly context menu options, covering breaking vs. non-breaking sort behavior for pivot table, tree table, and table widgets, and how to order members manually by dragging and dropping their c…
- [Show or hide totals](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/analyze-data/show-or-hide-totals.md): How to control totals visibility in Atoti UI tables and KPI widgets, including toggling grand total rows and columns and per-level subtotals from the Totals context menu, with advanced control via mdx.hiddengrandtotals and mdx.hiddensubtotals.
- [Highlight key data](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/analyze-data/highlight-key-data.md): How to highlight key data in Atoti UI table widgets by emphasizing a cell's row and column on hover, with an optional pinned highlight whose shape and color are configurable.
- [Add a calculation to a widget](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/analyze-data/add-a-calculation-to-a-widget.md): How to define a calculated measure or a calculated member on a single widget in Atoti UI with the Add a calculation submenu of tables and charts, how such a calculation is stored in the widget's query rather than on the cube, and how to edit or delete it afterwards.
- [Drill down](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/analyze-data/drill-down.md): How to expand and collapse hierarchy levels in Atoti UI tables using the drilldown caret, drill down by a different hierarchy using Drill down all or Drill down one by one, and build drilldown chains for multi-level data exploration.
- [Drillthrough](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/analyze-data/drillthrough.md): How to add a drillthrough table to an Atoti UI dashboard, either from the widgets panel or from a widget's context menu by right-clicking a table cell or chart point to filter by the selected members on a new dashboard page.
- [Explore data with expanding hierarchies](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/analyze-data/expand-collapse-hierarchies.md)
- [Investigations](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/analyze-data/investigations.md): How to set up and trigger investigations in Atoti UI using the Behavior tab, by linking a widget's context menu to a dedicated dashboard page that opens filtered on the selected table cell or chart data point.
- [Context values](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/analyze-data/context-values.md): How to use the Query context tab in Atoti UI to set query parameters such as queriesTimeLimit, mdx.casesensitive, mdx.lightcrossjoin, epoch.id, and drillthrough.behavior at the default, dashboard, page, or widget scope.
- [How to investigate your data with filters](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/analyze-data/use-filters.md): Video tutorial showing how to investigate data with filters in Atoti UI, demonstrating how to add, adjust, and remove filters to narrow down query results on a dashboard.
- [4 ways to investigate your data](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/analyze-data/ways-to-investigate.md): Video tutorial covering four ways to investigate data in Atoti UI, including using filters, drill-down, drillthrough, and investigations to explore and analyze dashboard data.

#### Modify the cube from the UI

- [Calculated measures](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/modify-the-cube-from-the-ui/calculated-measures.md): How to create, edit, rename, and delete calculated measures in Atoti UI using the fx+ button in the data model, including MDX templates, the Save and apply workflow, the canUseCalculatedMeasures permission, and how saved calculated measures appear in the data model with the fx icon.
- [Calculated members](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/modify-the-cube-from-the-ui/calculated-members.md): How to create, edit and delete the calculated members of a hierarchy in Atoti UI from the Manage members popover, including the parent member, the MDX expression templates, the Save and apply workflow, the canUseCalculatedMembers permission, and where calculated members are displayed.

#### Exports

- [Export to CSV or PDF](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/user-guide/exports/export-to-csv-or-pdf.md): How to export widget data to CSV and export dashboards to PDF in Atoti UI using the context menu Export to CSV option and the File menu Export to PDF option, with settings for page selection and CSV cell separator configuration.

### Developer guide

- [Authentication](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/authentication.md): How Atoti UI retrieves a JWT from the jwtServer and uses it across embedded and remote deployment setups, covering the login and logout flows, WebSocket authentication via cookie, CORS configuration, and custom authentication via configuration.higherOrderComponents.
- [Integrate Atoti UI components](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/integrate-atoti-ui-components.md): How to embed Atoti UI components into a React application using PluginsProvider, ClientsProvider, IntlProvider, ThemeProvider, and UserProvider from @activeviam/atoti-ui-sdk, with the Widget component as a worked example.
- [Share dashboards with URL filters](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/share-dashboards-with-url-filters.md)

#### Install and start

- [Set up](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/install-and-start/set-up.md): How to install and start Atoti UI using the atoti-ui-starter or atoti-ui-starter-source from Artifactory, covering the three setup paths: no customizations, with customizations using ExtensionModule, and integrating Atoti UI components into an existing application.

##### Compatibility

- [Browsers](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/install-and-start/compatibility/browsers.md): Supported web browsers for Atoti UI, listing compatible browser names and the minimum required version for each browser on supported platforms.
- [Atoti Java SDK](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/install-and-start/compatibility/atoti-java-sdk.md): Compatibility matrix between Atoti UI and Atoti Java SDK versions, showing the minimum required and highest compatible Atoti UI version for each Atoti Java SDK release from 5.4 to 6.1.

#### Customize Atoti UI

- [User settings](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/customize-atoti-ui/user-settings.md): How to update user settings in Atoti UI via Atoti Admin UI or the Settings popup, including managing organization-wide defaults, consuming settings via the useSetting hook, registering custom SettingDefinition objects, and grouping them with SettingsGroup.
- [Permissions](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/customize-atoti-ui/permissions.md): How permissions in Atoti UI are managed via Atoti Admin UI at the user, group, and organization levels, including editing the canShare, canUseCalculatedMeasures and canUseCalculatedMembers properties in JSON permissions files stored on the **Content server**.
- [Programmatic export to PDF](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/customize-atoti-ui/programmatic-export-to-pdf.md): How to export Atoti UI dashboards to PDF programmatically using the ?export URL parameter and the dashboardLoaded event with window.print(), and how to make custom widgets exportable by calling onLoaded from WidgetPluginInDashboardProps.

##### Brand the UI

- [Colors](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/customize-atoti-ui/brand-the-ui/colors.md): How to customize colors in Atoti UI by registering custom themes via configuration.themes in index.ts, selecting them via the CoreSettings theme property in the Settings popup, and applying a ThemeProvider in standalone React integrations.

##### Customize navigation

- [Configure the application menu](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/customize-atoti-ui/customize-navigation/configure-the-application-menu.md): How to customize the Atoti UI application menu by configuring leftApplicationMenu and rightApplicationMenu in the Configuration object, using built-in items such as applicationSubMenuHelp, applicationMenuItemAbout, and applicationMenuItemDocumentation.

##### Customize the dashboard

- [Create a custom widget](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/customize-atoti-ui/customize-the-dashboard/create-a-custom-widget.md): How to create and register a custom widget in Atoti UI using the WidgetPlugin interface and WidgetPluginProps type, including defining the component, key, and initialState, wiring it into the widgetPlugins array, and optionally connecting it to the server via useQueryResult.
- [Create a popup](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/customize-atoti-ui/customize-the-dashboard/create-a-popup.md): How to add popups and modals to Atoti UI using the Ant Design Modal component or the useModal hook, including making a modal compatible with useModal, registering it in Configuration.modals, and opening it programmatically with openModal.
- [Interact with the application state](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/customize-atoti-ui/customize-the-dashboard/interact-with-the-application-state.md): How to read and update the Atoti UI Redux state using useSelector and useDispatch from react-redux, including selectors such as getIsPresenting and getDashboardState, dispatching Action types, and extending the state using storeEnhancers in Configuration.

###### Customize existing widgets

- [Create a custom menu item](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/customize-atoti-ui/customize-the-dashboard/customize-existing-widgets/create-a-custom-menu-item.md): How to create and register a custom context menu item for widgets in Atoti UI using MenuItemPlugin and the useMenuItem hook, including wiring the plugin key into a widget's contextMenuItems list in plugins.ts.

###### Manage the tool panel

- [Introduction to the tool panel](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/customize-atoti-ui/customize-the-dashboard/manage-the-tool-panel/introduction-to-the-tool-panel.md): What the Atoti UI tool panel is, why it is a developer extension point in dashboards, and the available customization options including configuration.tools, the built-in toolQueryEditor and toolStateEditor exports, and the custom Tool interface.
- [Configure the tool panel](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/customize-atoti-ui/customize-the-dashboard/manage-the-tool-panel/configure-the-tool-panel.md): How to add and remove tools in the Atoti UI tool panel by modifying configuration.tools in the activate function, using built-in exports such as toolQueryEditor, toolStateEditor, and toolQueryContextEditor from @activeviam/atoti-ui-sdk.
- [Create a custom tool](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/customize-atoti-ui/customize-the-dashboard/manage-the-tool-panel/create-a-custom-tool.md): How to create a custom tool for the Atoti UI tool panel by implementing the Tool interface with a key, component accepting EditorProps, type, and icon, then registering it by pushing it to configuration.tools in the activate function.
- [Activate the state tab](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/customize-atoti-ui/customize-the-dashboard/manage-the-tool-panel/activate-the-state-tab.md): How to enable the advanced-extension in Atoti UI to expose the State tab, Query context tab, and Text editor widget, by editing extensions.json in Java or standalone deployments or via the Python SDK customization API.

##### Reuse extensions

- [Introduction to extending Atoti UI](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/customize-atoti-ui/reuse-extensions/introduction-to-extending-atoti-ui.md): What Atoti UI extensions are and why they are preferable to NPM modules for distributing UI customizations, covering how extensions are packaged, deployed without rebuilds, and grouped for shared use across Atoti UI projects.
- [Create reusable extensions](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/customize-atoti-ui/reuse-extensions/create-reusable-extensions.md): How to create, build, and plug reusable Atoti UI extensions using @activeviam/atoti-ui-cli and ExtensionModule, including structuring the NPM module, running atoti-ui-cli build-extension, and registering extensions via extensions.json.

#### Reference

- [Components](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/reference/components.md)
- [Context providers](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/reference/context-providers.md)
- [Errors](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/reference/errors.md)
- [Functions](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/reference/functions.md)
- [Hooks](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/reference/hooks.md)
- [Types](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/reference/types.md)
- [Variables](https://docs.activeviam.com/data-visualization/atoti-ui/5.2/developer-guide/reference/variables.md)