nextcloud / nextcloud/documentation

Missing Documentation for String-Based Permission Values

Open
#13,291 3 comments 0 reactions 1 assignee View on GitHub

@icewind1991 is already working on this.

Since Jul 7, 2025.

1. to develop
Dominant language
JavaScript
Stars
628
Forks
2.5k
Avg merge
2d 11h
Merged PRs (30d)
135

Description

In this documentation, permissions are represented as integer values such as (int) 1 = read; 2 = update; 4 = create; 8 = delete; 16 = share; 31 = all (default: 31, for public shares: 1).

However, when performing a PROPFIND operation, the permission information returned for files is in a string format (e.g., SGDNV, SRGDNVCK).

The correlation between these string and the integer values is missing.

According to my tests

SRGDNVCK → Can Edit
SGDNV → Custom Permission only Edit
Also, SGDNV → View Only

We need to know which custom permission is active for a file based on its string value on the client side, so that we can implement this feature.

Version: 31.0.6.2

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.