Skip to content

spo folder remove

Deletes the specified folder

Usage

spo folder remove [options]

Options

Option Description
--help output usage information
-u, --webUrl <webUrl> The URL of the site where the folder to be deleted is located
-f, --folderUrl <folderUrl> Site-relative URL of the folder to delete
--recycle Recycles the folder instead of actually deleting it
--confirm Don't prompt for confirming deleting the folder
-o, --output [output] Output type. json|text. Default text
--verbose Runs command with verbose logging
--debug Runs command with debug logging

Important

Before using this command, log in to a SharePoint Online site, using the spo login command.

Remarks

To delete a folder, you have to first log in to SharePoint using the spo login command, eg. spo login https://contoso.sharepoint.com.

The spo folder remove command will remove folder only if it is empty. If the folder contains any files, deleting the folder will fail.

Examples

Removes a folder with site-relative URL /Shared Documents/My Folder located in site https://contoso.sharepoint.com/sites/project-x

spo folder remove --webUrl https://contoso.sharepoint.com/sites/project-x --folderUrl '/Shared Documents/My Folder'

Moves a folder with site-relative URL /Shared Documents/My Folder located in site https://contoso.sharepoint.com/sites/project-x to the site recycle bin

spo folder remove --webUrl https://contoso.sharepoint.com/sites/project-x --folderUrl '/Shared Documents/My Folder' --recycle