Permissions & Sharing
Frappe Drive provides a flexible permission system that lets you control who can view, edit, upload, or share your files and folders. Permissions can be granted to individual users, teams, or everyone through public links.
Folder permissions are inherited by their contents unless explicitly overridden, making it easy to manage access across large folder structures.
How Permissions Work
Permissions flow from parent folders to their contents. Files and subfolders inherit access from their parent until a different permission is applied directly to them.
Permission Levels
Frappe Drive supports three permission levels:
- View — Allows users to view, download, comment on, and share files.
- Edit — Allows users to modify files and documents.
- Upload — Allows users to upload files into a shared folder.
Default Permissions
Home Folder
Items stored inside your Home folder are private by default.
- Only you can access your files and folders.
- You can share individual files or folders with other users whenever required.
Team Workspace
Files and folders inside a Team workspace automatically provide basic collaboration permissions.
- All team members can view files.
- All team members can upload files.
- Edit access must be granted explicitly.
Folder Permission Inheritance
Permissions applied to a folder are inherited recursively by all files and subfolders beneath it.
For example:
Folder A
├── file.txt
├── file2.txt
└── Folder C
└── file3.jpeg
Folder B
└── file4.docIf Folder A is shared with a user using View permission, every item inside the folder—including Folder C and file3.jpeg—inherits the same permission.
However, if Folder C is later configured with its own permissions (for example, made private), the inherited permission stops there. Users who only inherited access from Folder A will no longer be able to access Folder C or any files inside it.
Inheritance Rule
When checking access to a file or folder, Frappe Drive searches upward through the folder hierarchy until it finds an explicitly configured permission. If none exists, the default permissions for the workspace are applied.
Sharing Files and Folders
You can share files and folders with different audiences depending on your collaboration needs.
- Specific users
- Teams
- Everyone using a public link
Public Sharing
When a file or folder is shared publicly, anyone with the public link can access it without signing in to Frappe Drive.
- File Sharing
- Team Workspaces
- Guest Users
- Access Control
- Activity Logs
Best Practices
- Share folders instead of individual files when collaborating on projects.
- Grant the minimum permission level required for each user.
- Override inherited permissions only when necessary.
- Review public shares regularly to ensure sensitive files remain protected.
- Use Team workspaces for collaborative projects and Home for private files.
