Datalore 2025.6 Help

Add workspace files

When you add files to a workspace, they become available in all notebooks within that workspace. In your Private workspace, you need to explicitly attach files to individual notebooks to access them from code.

To view workspace files from within a notebook, select Attached data | [workspace_name] workspace files. To use workspace files in your code, specify the full file path, such as /data/workspace_files/<file_name>.

Add from the Home page

Upload workspace files from the Home page

  1. In the sidebar on the Home page, select the workspace where you want to upload files.

  2. In the expanded list of workspace resources, select Document Data.

  3. Click Icon of a paper sheet with an arrow pointing upward Upload files at the top right.

    The Files tab and the 'Upload files' button
  4. In the file dialog, select one or more files on your local machine.

  5. (Optional) If your upload includes .ipynb files, you will see the Import... dialog suggesting you import them as notebooks. Select one of the following options:

    • Import: Import these files as notebooks and add to the Book Notebooks section of the workspace.

    • Upload: Upload these files to the Document Data section of the workspace.

    • Cancel: Abort the uploading process.

    Import notebook dialog asking if the user wants to import a file as a notebook

Upload a folder from the Home page

  1. In the sidebar on the Home page, select the workspace where you want to upload a folder.

  2. In the expanded list of workspace resources, select Document Data.

  3. Click Down-pointing triangle icon (More) at the top right and select Upload folder.

    The 'Files' tab with the options dropdown open. The options include Upload folder
  4. In the file dialog, select the folder on your local machine.

  5. (Optional) In the Import... dialog, review how the files will be imported and adjust settings if needed.

    • To exclude a file from the upload, uncheck the corresponding checkbox.

    • To upload a notebook as a file, select File in the dropdown in the Import as column.

      The notebook will be added to the Document Data section.

    Import notebooks and files dialog prompting the user to specity import options
  6. Click Import.

Create a file or folder in a workspace

  1. In the sidebar on the Home page, select the workspace where you want to create a file or folder.

  2. In the expanded list of workspace resources, select Document Data.

  3. Click Down-pointing triangle icon (More) at the top right.

    The Files tab with the options dropdown open. The options include New file and New folder
  4. Select New file or New folder.

  5. Enter a name for the new file or folder, then press Enter.

  6. To open the file in the text editor, double-click the file name.

    The changes that you make are saved automatically every ten seconds or when you press ⌘+S.

Add workspace files from the editor

When you are working on a notebook in the editor, you can add files to the workspace in the Attach Attached data section.

Upload workspace files in the Attached data section

  1. In your notebook, select Attach Attached data in the sidebar.

  2. Next to [Name]'s workspace files title, click + and select Upload files or Upload folder.

    Dropdown menu with options to create or upload a workspace file or folder
  3. Select the file or folder on your local machine.

Create workspace files in the Attached data section

Instead of uploading a workspace file, you can create a file in Datalore and paste data or code into it.

You can create CSV, TSV, JSON, and other text files.

  1. In your notebook, select Attach Attached data in the sidebar.

  2. Next to [Name]'s workspace files title, click Plus and select New file.

    Dropdown menu with options to create or upload a workspace file or folder
  3. Enter a name for the new file, then press Enter.

  4. To open the file in the text editor, double-click the file name.

    The changes that you make are saved automatically every ten seconds or when you press ⌘+S.

Next steps

17 November 2025