Edit

Share via

Create folders in workspaces

  • Article

This article explains what folders in workspaces are and how to use them in workspaces in Microsoft Fabric. Folders are organizational units inside a workspace that enable users to efficiently organize and manage artifacts in the workspace. For more information about workspaces, see the Workspaces article.

Create a folder in a workspace

  1. In a workspace, select New > Folder.

    Screenshot showing entry point of folder creation in new menu.

  2. Enter a name for the folder in the New folder dialog box. See Folder name requirements for naming restrictions.

    Screenshot showing New Folder dialog with a sample folder name.

  3. The folder is created successfully.

    Screenshot showing a folder is created successfully.

  4. You can create nested subfolders in a folder in the same way. Maximum 10 level nested subfolders can be created.

    Note

    You can nest up to 10 folders within the root folder.

Folder name requirements

Folder names must follow certain naming conventions:

  • The name can't include C0 and C1 control codes.
  • The name can't contain leading or trailing spaces.
  • The name can't contain these characters: ~"#.&*:<>?/{|}.
  • The name can't contain system-reserved names, including: $recycle.bin, recycled, recycler.
  • The name length can't exceed 255 characters.
  • You can't have more than one folder with the same name in a folder or at the root level of the workspace.

Move items into a folder

Move a single item

  1. Select the context menu (...) of the item you want to move, then select Move to.

    Screenshot showing the entrypoint of move to button in context menu of an item.

  2. Select the destination folder where you want to move this item.

    Screenshot showing the dialog for selecting destination folder.

  3. Select Move here.

    Screenshot showing move here button in the destination folder.

  4. By selecting Open folder in the notification or navigating to the folder directly, you can go to the destination folder to check if the item moved successfully.

    Screenshot showing the notification for moving successfully.

Move multiple items

  1. Select multiple items, then select Move from the command bar.

    Screenshot showing multi-selected items and move button.

  2. Select a destination where you want to move these items. You can also create a new folder if you need it.

    Screenshot showing new folder button in destination selector dialog.

Create an item in a folder

  1. Go to a folder, select New, then select the item you want to create. The item is created in this folder.

    Screenshot showing create item from new menu inside a folder.

    Note

    Currently, you can't create certain items in a folder:

    • dataflow gen2
    • streaming semantic model
    • streaming dataflow

    If you create items from the home page or the Create hub, items are created in the root level of the workspace.

Publish to folder (preview)

You can now publish your Power BI reports to specific folders in your workspace.

When you publish a report, you can choose the specific workspace and folder for your report, seen below.

Screenshot showing selecting a folder for where a report gets published.

To publish reports to specific folders in the service, make sure the Publish dialogs support folder selection setting is enabled in the Preview features tab in the options menu.

Screenshot showing selecting publish dialogs support folder selection box.

Rename a folder

  1. Select the context (...) menu, then select Rename.

    Screenshot showing rename folder entry point in context menu.

  2. Give the folder a new name and select the Rename button.

    Screenshot showing inputting name in rename dialog.

Note

When renaming a folder, follow the same naming convention as when you're creating a folder. See Folder name requirements for naming restrictions.

Delete a folder

  1. Make sure the folder is empty.

  2. Select the context menu (...) and select Delete.

    Screenshot showing delete folder entry point in contextual menu.

    Note

    Currently you can only delete empty folders.

Permission model

Workspace admins, members, and contributors can create, modify, and delete folders in the workspace. Viewers can only view folder hierarchy and navigate in the workspace.

Currently folders inherit the permissions of the workspace where they're located.

Capability Admin Member Contributor Viewer
Create folder ✅ ✅ ✅ ❌
Delete folder ✅ ✅ ✅ ❌
Rename folder ✅ ✅ ✅ ❌
Move folder and items ✅ ✅ ✅ ❌
View folder in workspace list ✅ ✅ ✅ ✅

Considerations and limitations

  • Currently dataflow gen2, streaming semantic model, and streaming dataflow can't be created in folders.
  • If you trigger item creation from the home page, create hub, and industry solution, items are created at the root level of workspaces.
  • Git doesn't support workspace folders yet.
  • If folders is enabled in the Power BI service but not enabled in Power BI Desktop, republishing a report that is in a nested folder will replace the report in the nested folder.
  • If Power BI Desktop folders is enabled in Power BI Desktop, but not enabled in the Service and you publish to a nested folder, the report will be published to the general workspace.
  • When publishing reports to folders, report names must be unique throughout an entire workspace, regardless of its location. Therefore, when publishing a report to a workspace that has another report with the same name in a different folder, the report will publish to the location of the already existing report. If you want to move the report to a new folder location in the workspace you will need to make this change in the Power BI Service.
  • Folders are not supported in Template App workspaces.

Related content