Yandex Cloud
Search
Discuss with expertTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
    • Cloud Interconnect
    • Cloud Backup
    • Cloud Registry
    • Yandex AI Studio
    • Compute Cloud
    • Object Storage
    • Managed Service for Kubernetes®
    • Yandex BareMetal
    • Smart Web Security
    • Security Deck
    • Managed Service for PostgreSQL
    • Managed Service for ClickHouse®
    • Monium
    • Cloud CDN
    • Network Load Balancer
    • Virtual Private Cloud
    • Cloud DNS
    • Application Load Balancer
    • Yandex Cloud Video
    • Stackland
    • Yandex Cloud Router
    • Yandex Managed Service for Trino
    • Managed Service for MySQL®
    • Managed Service for Valkey™
    • Managed Service for Apache Spark™
    • Yandex StoreDoc
    • Managed Service for OpenSearch
    • Managed Service for Apache Kafka®
    • Data Transfer
    • Yandex MPP Analytics Engine for PostgreSQL
    • Yandex Managed Service for Apache Airflow®
    • Data Processing
    • Yandex MetaData Hub
    • Managed Service for YDB
    • Managed Service for Sharded PostgreSQL
    • Managed Service for YTsaurus
    • Yandex WebSQL
    • DataLens
    • Yandex Search API
    • SpeechSense
    • SpeechKit
    • DataSphere
    • Vision OCR
    • Translate
    • Yandex Identity Hub
    • Key Management Service
    • Certificate Manager
    • Yandex Lockbox
    • Audit Trails
    • SmartCaptcha
    • Cloud Desktop
    • SourceCraft Code Assistant
    • Container Registry
    • Managed Service for GitLab
    • Managed Service for Prometheus®
    • Cloud Functions
    • API Gateway
    • Yandex Cloud Postbox
    • Message Queue
    • Serverless Integrations
    • IoT Core
    • Data Streams
    • Serverless Containers
    • Cloud Notification Service
    • Yandex Query
    • Identity and Access Management
    • Yandex Cloud Console
    • Resource Manager
    • Yandex Cloud Billing
    • Yandex Cloud Quota Manager
    • Cloud Apps
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Yandex DataLens
    • Overview
    • Operations with workbooks
    • Operations with collections
    • Migrating objects to workbooks from directories
    • Exporting and importing workbooks
    • Errors and warnings during export and import
  • DataLens neuroanalyst
  • Gallery in DataLens
  • Audit Trails events

In this article:

  • Features of the new approach
  • How to enable workbooks and collections
  • Viewing linked objects
  1. Workbooks and collections
  2. Overview

Yandex DataLens workbooks and collections

Written by
Yandex Cloud
Improved by
Ivan B.
Updated at July 17, 2026
View in Markdown
  • Features of the new approach
  • How to enable workbooks and collections
  • Viewing linked objects

Workbooks and collections are a new way to store objects in DataLens, which is alternative to the old navigation across folders. This new approach allows you to place DataLens objects in special containers:

  • A workbook stores connections, datasets, charts, dashboards, and reports.

    Workbook

    image

  • A collection is a container used for grouping workbooks and other collections.

Features of the new approachFeatures of the new approach

Workbooks make it much easier to work with objects:

  • They allow you to consistently set up permissions to linked objects: connections, datasets, charts, and dashboards.

  • With them, you can set up permissions for user groups.

  • You can copy workbooks maintaining the integrity of internal links and making their copies independent of the original.

    Note

    Copying workbooks with file connections is not supported.

  • You can group workbooks into collections.

Objects in workbooks and in folders of the legacy object model are independent:

  • A workbook cannot be placed inside a folder.
  • An object from a workbook cannot be added to a dashboard placed inside a folder.
  • Folders do not support customization of user group access.
  • An object from a workbook cannot be moved to a folder.

How to enable workbooks and collectionsHow to enable workbooks and collections

Warning

  • To enable workbooks, a user must have the datalens.admin role. They can do this only if a DataLens instance is deployed at the organization level.
  • Only workbooks and collections are available in new DataLens instances.

To get started with workbooks:

  1. In the left-hand panel, select Service settings.

  2. Select the Navigation tab.

  3. Under Workbooks, click Enable workbooks.

    Workbooks enabled

    image

To transfer any object from a folder to a workbook, perform migration. If you are not going to use folder navigation anymore, you can disable it.

Viewing linked objectsViewing linked objects

You can look up where the object is used or which objects are used by it. Do it by clicking → Linked objects on the workbook page or object editing window. For example, this can give you a clue as to the sources used to build a dashboard or the charts based on a certain dataset.

Linked object window

image

If you get an error when opening the linked object window, click Retry.

Was the article helpful?

Previous
Courses
Next
Operations with workbooks
© 2026 Direct Cursus Technology L.L.C.