| title | description | author | ms.author | ms.reviewer | ms.topic | ms.custom | ms.search.form | ms.date |
|---|---|---|---|---|---|---|---|---|
Create folders in workspaces |
Learn how to create a folder inside a workspace to enable users to efficiently organize and manage items in the workspace. |
paulinbar |
painbar |
yicw, mesrivas,liud |
how-to |
fabric |
product-trident, Manage your workspace |
12/16/2024 |
This article explains what folders in workspaces are and how to use them in workspaces in [!INCLUDE product-name]. 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.
-
In a workspace, select New folder.
:::image type="content" source="media/workspaces-folders/create-folder-new-menu.png" alt-text="Screenshot showing entry point of folder creation in new menu.":::
-
Enter a name for the folder in the New folder dialog box. See Folder name requirements for naming restrictions.
:::image type="content" source="media/workspaces-folders/input-name-new-folder-dialog.png" alt-text="Screenshot showing New Folder dialog with a sample folder name.":::
-
The folder is created successfully.
:::image type="content" source="media/workspaces-folders/newly-created-folder-workspace.png" alt-text="Screenshot showing a folder is created successfully.":::
-
You can create nested subfolders in a folder in the same way. A maximum of 10 levels of nested subfolders can be created.
[!NOTE] You can nest up to 10 folders in the root folder.
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.
-
Select the context menu (...) of the item you want to move, then select Move to.
:::image type="content" source="media/workspaces-folders/select-move-context-menu.png" alt-text="Screenshot showing the entrypoint of move to button in context menu of an item." lightbox="media/workspaces-folders/select-move-context-menu.png":::
-
Select the destination folder where you want to move this item.
:::image type="content" source="media/workspaces-folders/select-destination-folder.png" alt-text="Screenshot showing the dialog for selecting destination folder." lightbox="media/workspaces-folders/select-destination-folder.png":::
-
Select Move here.
:::image type="content" source="media/workspaces-folders/select-move-here.png" alt-text="Screenshot showing move here button in the destination folder." lightbox="media/workspaces-folders/select-move-here.png":::
-
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.
:::image type="content" source="media/workspaces-folders/notification-moved-successfully.png" alt-text="Screenshot showing the notification for moving successfully.":::
-
Select multiple items, then select Move from the command bar.
:::image type="content" source="media/workspaces-folders/multi-select-items-move.png" alt-text="Screenshot showing multi-selected items and move button." lightbox="media/workspaces-folders/multi-select-items-move.png":::
-
Select a destination where you want to move these items. You can also create a new folder if you need it.
:::image type="content" source="media/workspaces-folders/create-new-folder-while-moving.png" alt-text="Screenshot showing new folder button in destination selector dialog." lightbox="media/workspaces-folders/create-new-folder-while-moving.png":::
-
Go to a folder, select New, then select the item you want to create. The item is created in this folder.
:::image type="content" source="media/workspaces-folders/create-items-folder.png" alt-text="Screenshot showing create item from new menu inside a folder." lightbox="media/workspaces-folders/create-items-folder.png":::
[!NOTE] Currently, you can't create certain items in a folder:
- Dataflows gen2
- Streaming semantic models
- Streaming dataflows
If you create items from the home page or the Create hub, items are created at the root level of the workspace.
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, as illustrated in the following image.
:::image type="content" source="media/workspaces-folders/publish-folder-select-folder.png" alt-text="Screenshot showing selecting a folder for where a report gets published." lightbox="media/workspaces-folders/publish-folder-select-folder.png":::
To publish reports to specific folders in the service, make sure that in Power BI Desktop, the Publish dialogs support folder selection setting is enabled in the Preview features tab in the options menu.
:::image type="content" source="media/workspaces-folders/publish-folder-dialog.png" alt-text="Screenshot showing selecting publish dialogs support folder selection box." lightbox="media/workspaces-folders/publish-folder-dialog.png":::
-
Select the context (...) menu, then select Rename.
:::image type="content" source="media/workspaces-folders/rename-folder.png" alt-text="Screenshot showing rename folder entry point in context menu.":::
-
Give the folder a new name and select the Rename button.
:::image type="content" source="media/workspaces-folders/input-name-rename-dialog.png" alt-text="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.
-
Make sure the folder is empty.
-
Select the context menu (...) and select Delete.
:::image type="content" source="media/workspaces-folders/delete-folder.png" alt-text="Screenshot showing delete folder entry point in contextual menu.":::
[!NOTE] Currently you can only delete empty folders.
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 | ✅ | ✅ | ✅ | ✅ |
- Currently dataflows gen2, streaming semantic models, and streaming dataflows 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 currently support workspace folders.
- 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 their 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 need to make this change in the Power BI service.
- Folders are not supported in Template App workspaces.