Skip to content

Group Management#

Publishers and Collaborators can use "groups" to associate multiple users to content as viewers or collaborators. This can often provide an easier alternative to maintaining a discrete list of users associated with each instance of published content.


By default, publishers can use the groups already available in RStudio Connect, but they cannot themselves add new groups. If your use case requires publishers to have such privileges, please see the section on Publisher Ownership of Groups on the Advanced User / Group Topics appendix.

Depending upon the authentication provider that RStudio Connect is configured to use, groups will either be managed locally (by RStudio Connect) or managed remotely (by your authentication provider). The functionality available from within RStudio Connect will change depending upon this relationship as well as the capabilities of the authentication provider.

Local Group Management#

An administrator in RStudio Connect can use the dashboard, specifically the "People" tab to create groups and manage their members. Groups can also be managed via the Connect Server API. Group support is available for all authentication providers and enabled by default.


Local group support can be disabled with Authorization.UserGroups. Disabling this setting is not effective if groups are still present. RStudio Connect will issue a warning on startup and ignore this setting. In order to use this setting all groups must be removed first.

Remote Group Management#

RStudio Connect provides the ability to reference externally managed groups from some authentication providers. When these are configured, management of the remote groups remains the responsibility of the external authentication provider. While the RStudio Connect dashboard may provide some convenience functionality, the remote authentication provider's interfaces should be used for most membership operations.

Within the RStudio Connect dashboard (group section under "People" tab), references to the externally managed groups are configured by "adding" a group. Memberships for these referenced groups are locally synchronized in RStudio Connect through several mechanisms:

  • Group memberships are updated on each and every successful login attempt.

  • Changes to group memberships are only detected if the user logs out and logs back in.

  • Group references not yet known by RStudio Connect are created on each successful login attempt when Automatic Group Provisioning is enabled for the auth provider.