About Visual Permissions
Visual permissions allow you to permit your entire account, groups within your account, or users within your account to read, write, or delete a visual. This allows you to share a visual with other users.
If a user belongs to a group that has the Can Administer Visualsprivilege enabled, the user can read, add, modify, or remove any visual in the Composer account. However, if the user does not belong to a group with this privilege enabled, the user can still be granted permission to read, write, or delete specific visuals in the account using visual permissions. Visual permissions allow users in an account or group to read, write, or delete a visual, regardless of any group privilege settings that ordinarily limit their ability to do so.
To manage permissions of a visual, your Composer user definition must meet one of the following criteria:
It must be an administrator, belonging to the Administrators group
It must belong to a group with the Can Administer Visuals (ROLE_ADMINISTER_VISUALS) privilege enabled.
It must belong to a group with the Can Manage Visual Permissions (ROLE_PERMISSION_VISUALS) privilege enabled. If your user definition has only this privilege (and not the Can Administer Visuals privilege), you will only be able to manage permissions for the visuals you can read.
In addition, you may be restricted in which permissions you can assign. You can only assign permissions equivalent to your own. For example, if your user account has read permission for a visual, you can grant and revoke the read option available on the Visual Permissions panel. If you have write permission for a visual, you can grant and revoke the write option on the Visual Permissions panel.
If your user definition does not have read permission for a visual, you cannot view the visual in the Visual Gallery. If your user definition does not have write permission for a visual, you cannot save the visual.
Visual permissions are determined using a most permissive model. For more information, see How Visual Permissions Are Determined.
If you upgrade from a previous version to Composer 6.9, previously created visuals are automatically granted account, group, or user permissions for the visual based on their current permissions for the data source used by the visual.
Visual permission specifications can also be made using the API endpoints
GET /api/visuals/<visualId>/acls, and
/api/user/permissions/visuals/<visualId>. API documentation is provided with your Composer installation at this link:
For more information, see the following topics: