> For the complete documentation index, see [llms.txt](https://docs.docbits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docbits.com/administration-and-setup/settings/global-settings/groups-users-and-permissions/groups-and-permissions/activating-permissions.md).

# Activating Permissions

{% embed url="<https://youtu.be/xE4RQnbOMug>" %}
DocBits Groups & Permissions Tutorial: Set User Roles, Access Rights & Secure Your Workspace
{% endembed %}

Enabling or disabling the permission system using the switch has various effects on the functionality in DocBits.

## **Enabling the permission system:**

<figure><img src="/files/PNJzS3YTnLqPCZE910D4" alt=""><figcaption></figcaption></figure>

* When the permission system is enabled, the access permissions for users and groups are applied.
* Users are only granted access to the resources they are explicitly authorized to access based on the permissions assigned.
* Administrators can manage the permissions for individual users and groups and ensure that only authorized people can view or edit the data.

<figure><img src="/files/rleTOtQLI7OAbKtGNDKZ" alt=""><figcaption></figcaption></figure>

## Only Assigned Documents

<figure><img src="/files/xnOu5rqyfg33aCDfMpve" alt=""><figcaption></figcaption></figure>

The **Only Assigned Documents** toggle button controls the visibility of documents for users based on their group assignments. When enabled, users can only view documents that are specifically assigned to them or a group they belong to. When disabled, users with the appropriate view permission can see all documents, regardless of assignment.

#### Functionality

* **Off State (Default)**:
  * When the toggle is off, users who are part of a group can view all documents if they have the appropriate view permission. Document assignment does not affect visibility.
* **On State**:
  * When the toggle is on, users can only view documents that are explicitly assigned to them or a group they are a part of. This enforces stricter document visibility based on group assignments.

#### Example Scenario

1. **Default (Off State)**:
   * A user who is part of the "Sales" group can see all documents in the system that they have permission to view, even if they are not assigned to those documents.
2. **Enabled (On State)**:
   * A user in the "Sales" group can only view documents that are assigned to them or the "Sales" group, restricting access to documents outside of their assignments.

## Disabling the permission system:

<figure><img src="/files/lWaNFeVNLpgfk1rH9vSH" alt=""><figcaption></figcaption></figure>

* When the permission system is disabled, all access permissions are removed and users typically have unrestricted access to all resources.
* This can be useful when open collaboration is temporarily required without the restrictions of access control.
* However, there may be an increased risk of data leakage or unauthorized access as users may be able to access sensitive information they are not authorized to access.

Enabling or disabling the permission system is an important decision based on the security requirements and the way the organization operates. In environments where privacy and access control are critical, it is common to leave the permission system enabled to ensure data integrity and confidentiality. In other cases, disabling the permission system may be temporarily necessary to facilitate collaboration, but should be used with caution to minimize potential security risks.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.docbits.com/administration-and-setup/settings/global-settings/groups-users-and-permissions/groups-and-permissions/activating-permissions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
