Workbooks and collections
Written by
Updated at June 25, 2026
Do I have to switch to workbooks?
Yes. Eventually, all navigation inside DataLens will be switched from folders to workbooks, so we recommend that you:
- Create new objects in workbooks.
- Migrate your existing objects to workbooks.
How will access permissions be migrated?
Right after the migration, you will become the sole workbook administrator and will be able to assign permissions to other users and user groups.
How does DataLens find linked objects during migration?
Link search depends on the selected type of migration:
- During migration by transfer, DataLens finds linked objects recursively across all links. Therefore, you can start migration from any object, e.g., from a dashboard. DataLens will find all linked charts, datasets, and connections. Then it will search for the links of the objects it found. Finally, it will prompt you to put all the objects it found into a single workbook.
- During migration by copying, DataLens searches for linked objects down the hierarchy. You can start copying from any object. The object's original copy remains in the directory. DataLens will prompt you to put its copy and copies of all found objects in a single workbook.
I used a single connection for multiple dashboards. DataLens prompts to place all of them in the same workbook. How can I get a separate workbook for each dashboard?
We recommend placing objects in different workbooks if you have different access permissions for them.
To get a separate workbook for each dashboard, use one of the following methods:
- First, copy all the dashboards from different workbooks. Then, remove the original objects from the folder structure.
- First, migrate all objects to a single workbook. Then, create copies of the workbook and delete the objects you do not need from each copy, only leaving the ones required for the relevant dashboard.