# RibbonPermissionsTab Object

> The type of the ribbonPermissionsTab property. The RibbonPermissionsTab object provides properties which can be used to configure the beahviour of the "Permissions" ribbon tab.

- **Product:** DS Server
- **Section:** Reference
- **Kind:** Object
- **Introduced:** 25.0
- **Path:** DS Server > Reference > JavaScript API > RibbonPermissionsTab Object
- **438 words**
- **Web URL:** https://docs.textcontrol.com/ds-server/reference/javascript/ribbonpermissionstab/
- **LLMs URL:** https://docs.textcontrol.com/ds-server/reference/javascript/ribbonpermissionstab/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/ds-server/reference/javascript/ribbonpermissionstab/llms-full.txt

---

### Description

The type of the [ribbonPermissionsTab property](https://docs.textcontrol.com/ds-server/reference/javascript/txtextcontrol/ribbonpermissionstab-property/llms-full.txt). The RibbonPermissionsTab object provides properties which can be used to configure the beahviour of the "Permissions" ribbon tab.

### Syntax

```javascript
{
   allowAdditionalUserNames: <boolean>,
   registeredUserNames: <string[]>
}
```

### Examples

The following example demonstrates `RibbonPermissionsTab` in a practical document-editing workflow. The type of the ribbonPermissionsTab property. The RibbonPermissionsTab object provides properties which can be used to configure the beahviour of the "Permissions" ribbon tab.

```javascript
function inspectRibbonPermissionsTab(ribbonPermissionsTab) {
    console.log("allow additional user names:", ribbonPermissionsTab.allowAdditionalUserNames);
    console.log("registered user names:", ribbonPermissionsTab.registeredUserNames);
}
```

---

## In This Section

- [Javascript: RibbonPermissionsTab.allowAdditionalUserNames Property](https://docs.textcontrol.com/ds-server/reference/javascript/ribbonpermissionstab/allowadditionalusernames-property/llms-full.txt): Gets or sets a value indicating whether the user can add user names by the RibbonPermissionsTab's Add Users dialog that are not represented by the registeredUserNames property. The default value is true.
- [Javascript: RibbonPermissionsTab.registeredUserNames Property](https://docs.textcontrol.com/ds-server/reference/javascript/ribbonpermissionstab/registeredusernames-property/llms-full.txt): Gets or sets an array of strings that represents those registered user names that can be added by the "Permissions" ribbon tab's Add Users dialog. The default value is an empty array.

---

## Nearby

- **Previous:** [Javascript: Ribbon.selectedTab Property](https://docs.textcontrol.com/ds-server/reference/javascript/ribbon/selectedtab-property/llms-full.txt)
- **Next:** [Javascript: RibbonPermissionsTab.allowAdditionalUserNames Property](https://docs.textcontrol.com/ds-server/reference/javascript/ribbonpermissionstab/allowadditionalusernames-property/llms-full.txt)