Most actions in the Iconik user interface make calls to the Iconik API. Roles control which of these actions a user can take, such as entering metadata, commenting or uploading.
The interface only shows the options your roles allow. For example, if you don't have the upload roles, you won't see the upload functionality. When comparing Iconik with the documentation, remember that some functionality is only available to users with the right role.
Your user type limits which roles you can have:
- Browse Only users can have the Browse Only roles.
- Standard users can have the Browse Only and Standard roles.
- Power Users can have all roles.
If you give a user a can_create role, also give them the matching can_write role. Write access includes read access by default, but you can change this by deselecting a specific role.
Roles alone aren't enough: users also need ACL access to the assets, collections and other objects they work with.
How to edit roles in a role group is covered in Roles Admin.
In the descriptions below:
- (API only) means the role controls an API feature that has no option in the Iconik apps.
- (Web UI only) means the role only shows or hides a feature in the Iconik apps. The API doesn't check it, so removing the role doesn't block the same action through the API.
Browse Only User Roles
| Role | Description |
|---|---|
can_approve_without_request |
Allows approval of an asset without going through the request stage (Web UI only) |
can_create_segments |
Allows creating comments |
can_delete_approval_status |
Allows deleting your own approvals |
can_delete_favorites |
Allows deleting favorites |
can_delete_saved_searches |
Allows deleting saved searches that you have access to |
can_delete_search_history |
Allows deleting your search history |
can_delete_segments |
Allows deleting your own comments |
can_list_all_groups |
Allows seeing all groups when listing groups. Otherwise only groups you are a member of are shown |
can_list_all_role_groups |
Allows seeing all role groups when listing role groups. Otherwise, only role groups you're a member of are shown. |
can_list_all_teams |
Allows seeing all teams when listing teams. Otherwise, only teams you're a member of are shown. |
can_list_all_users |
Allows seeing all users when listing users or querying for users |
can_list_group_users |
Only allows seeing users from groups you are a member of |
can_list_role_group_users |
Only allows seeing users from role groups you are a member of |
can_list_team_users |
Only allows seeing users from teams you are a member of |
can_read_acls |
Allows seeing who has access (ACLs) to assets, collections and other objects |
can_read_approval_request |
Allows being part of an approval workflow |
can_read_asset_relations |
Allows reading relations |
can_read_asset_subtitles |
Allows reading subtitles |
can_read_assets |
Allows reading assets |
can_read_collections |
Allows reading collections |
can_read_custom_actions |
Allows seeing custom actions |
can_read_dashboard |
Allows users to view the dashboard page (Web UI only) |
can_read_files |
Allows seeing files |
can_read_formats |
Allows seeing formats |
can_read_group_mappings |
Allows reading SAML group mappings (required for SAML) |
can_read_identity_providers |
Allows reading identity providers for SAML (Required for SAML) |
can_read_jobs |
Allows seeing jobs |
can_read_metadata_categories |
Allows seeing metadata categories (Required for metadata) |
can_read_metadata_fields |
Allows seeing metadata fields (needed to show metadata on assets) |
can_read_metadata_values |
Allows seeing metadata values |
can_read_metadata_views |
Allows seeing metadata views |
can_read_notification_settings |
Allows seeing notification settings |
can_read_notifications |
Allows seeing notifications |
can_read_person |
Allows reading persons (used for face recognition features) |
can_read_playlists |
Allows reading playlists |
can_read_portals |
Allows viewing portals |
can_read_proxies |
Allows viewing proxies |
can_read_saved_searches |
Allows access to saved searches |
can_read_search_history |
Allows access to search history |
can_read_search_views |
Allows reading saved search views |
can_read_segments |
Allows access to comments and time-based metadata |
can_read_shares |
Allows access to shares |
can_read_storages |
Allows access to the Storage list |
can_read_subscriptions |
Allows seeing notification subscriptions |
can_read_transcode_jobs |
Allows access to transcode jobs |
can_read_transcriptions |
Allows access to transcriptions |
can_read_transfers |
Allows seeing ongoing transfers |
can_search |
Allows searching |
can_write_approval_status |
Allows setting approval status (If part of an approval workflow) |
can_write_favorites |
Allows creating favorites |
can_write_saved_searches |
Allows saving searches |
can_write_segments |
Allows editing your own comments |
can_write_subscriptions |
Allows editing and deleting your notification subscriptions |
web_can_download_original |
Allows downloading the original file of an asset |
web_can_download_proxy |
Allows downloading the proxy file of an asset |
web_can_list_users |
Allows seeing the user list when sharing, and in other places you can list users (Web UI only) |
web_can_view_versions |
Allows viewing the different versions of assets |
web_enable_posters |
Allows seeing the Poster tab. To create posters, can_write_keyframes and can_create_poster are also required (Web UI only) |
Standard User Roles
| Role | Description |
|---|---|
can_add_person |
Allows adding persons for face recognition |
can_add_playlist_items |
Allows adding items to a playlist |
can_add_propagating_acls |
Allows adding ACLs that propagate to child objects |
can_analyze_content |
Allows access to the Analyze function |
can_archive_formats |
Allows archiving formats |
can_create_asset_relations |
Allows creating asset relations |
can_create_assets |
Allows creating new assets |
can_create_collections |
Allows creating new collections |
can_create_formats |
Allows uploading files (creating formats and file components) |
can_create_playlists |
Allows creating playlists |
can_create_portals |
Allows creating portals |
can_create_poster |
Allows creating poster images |
can_create_root_collections |
Allows creating collections in the root of the collection tree |
can_create_shares_to_upload |
Allows creating shares for upload (Web UI only) |
can_create_subclips |
Allows creating Subclips |
can_create_transcode_jobs |
Allows creating transcode jobs |
can_delete_acls |
Allows removing ACLs |
can_delete_approval_request |
Allows deleting an approval request |
can_delete_asset_relations |
Allows removing asset relations |
can_delete_assets |
Allows deleting assets |
can_delete_collections |
Allows deleting collections |
can_delete_files |
Allows deleting files |
can_delete_formats |
Allows deleting formats |
can_delete_object_shares |
Allows deleting shares |
can_delete_person |
Allows deleting person entries |
can_write_metadata_values |
Allows editing metadata |
can_delete_playlist_items |
Allows removing items from a playlist |
can_delete_playlists |
Allows deleting playlists |
can_delete_portals |
Allows deleting portals |
can_delete_proxies |
Allows deleting proxies |
can_delete_saved_search_groups |
Allows deleting Saved Search Groups |
can_delete_search_views |
Allows deleting search views |
can_delete_transcriptions |
Allows deleting transcriptions |
can_delete_versions |
Allows deleting versions of an asset |
can_edit_other_users_comments |
Allows editing and deleting other users' comments |
can_edit_person |
Allows editing person entries |
can_publish |
Allows publishing assets to connected social and web destinations |
can_purge_assets |
Allows purging assets from the recycle bin |
can_purge_collections |
Allows purging collections from the recycle bin |
can_read_assets_history |
Gives access to asset history |
can_read_export_locations |
Gives access to the Export Locations list |
can_read_posts |
Allows reading posts (Web UI only) |
can_reindex_assets |
Allows explicit reindex of assets |
can_reindex_collections |
Allows explicit reindex of collections |
can_reindex_person |
Allows explicit reindex of person entries |
can_reindex_playlists |
Allows explicit reindex of playlists |
can_reindex_portals |
Allows explicit reindex of portals (API only) |
can_reindex_segments |
Allows explicit reindex of segments (comments and time-based metadata) |
can_restore_archived_formats |
Allows restoring an archived format |
can_see_all_jobs |
Allows seeing all jobs regardless of ACLs |
can_transcribe_content |
Allows transcribing assets |
can_trigger_face_recognition |
Allows triggering face recognition analysis on assets |
can_trigger_metadata_ai_filling |
Allows triggering AI-powered metadata filling on assets |
can_update_playlist_items |
Allows updating playlist items |
can_update_playlist_items_position |
Allows reordering items in a playlist |
can_use_adobe_panel |
Allows using the Adobe panels (Web UI only) |
can_use_mcp |
Allows connecting AI assistants to Iconik through Iconik's built-in MCP server |
can_write_acls |
Allows setting ACLs |
can_write_approval_request |
Allows making Approval requests |
can_write_approval_status_in_bulk |
Allows doing bulk approvals |
can_write_asset_subtitles |
Allows adding subtitle files |
can_write_assets |
Allows editing assets |
can_write_collections |
Allows editing collections |
can_write_exports |
Allows creating exports |
can_write_files |
Allows updating file entries |
can_write_formats |
Allows updating format entries |
can_write_jobs |
Allows updating jobs |
can_write_keyframes |
Allows creating posters and setting keyframes (together with web_enable_posters and can_create_poster) |
can_write_playlists |
Allows editing playlists |
can_write_portals |
Allows editing portals and their styling |
can_write_proxies |
Allows updating proxies |
can_write_saved_search_groups |
Allows creating and updating Saved Search Groups |
can_write_search_views |
Allows creating and updating search views |
can_write_shares |
Allows updating shares |
can_write_transcode_jobs |
Allows updating transcode jobs |
can_write_transcriptions |
Allows creating and editing transcriptions |
can_write_transfers |
Allows updating transfers |
can_write_versions |
Allows creating new versions of assets |
is_storage_worker |
Special role for a user that acts as an Iconik Storage Gateway |
web_can_create_link_asset |
Allows creating Link assets from the web interface (Web UI only) |
web_can_create_placeholder |
Allows creating placeholders from the web interface (Web UI only) |
web_can_top_level_upload |
Allows uploading to the top level of a storage (Web UI only) |
web_can_upload |
Allows uploading using the web interface |
web_can_upload_legacy |
Allows uploading using the web interface without write ACL on the storage (legacy behaviour) |
Power User Roles
| Role | Description |
|---|---|
can_act_as_user |
Allows switching to another user |
can_create_users |
Allows creating users |
can_delete_acl_templates |
Allows deleting ACL templates |
can_delete_analysis_profiles |
Allows deleting AI analysis profiles |
can_delete_analysis_service_accounts |
Allows deleting AI analysis service accounts |
can_delete_apps |
Allows deleting applications and tokens |
can_delete_archived_formats |
Allows deleting an archived format |
can_delete_asset_relation_types |
Allows deleting asset relation types |
can_delete_assets_history |
Allows deleting an asset history entry |
can_delete_automations |
Allows deleting automations |
can_delete_cors_hosts |
Allows deleting CORS entries for the API (API only) |
can_delete_export_locations |
Allows deleting export locations |
can_delete_group_mappings |
Allows deleting group mappings (SAML only) |
can_delete_groups |
Allows deleting groups |
can_delete_identity_providers |
Allows deleting SAML identity providers |
can_delete_jobs |
Allows deleting jobs |
can_delete_logs_recipients |
Allows deleting Shield logs recipients |
can_delete_metadata_categories |
Allows deleting metadata categories |
can_delete_metadata_fields |
Allows deleting metadata fields |
can_delete_metadata_views |
Allows deleting metadata views |
can_delete_notifications |
Allows deleting notifications |
can_delete_role_groups |
Allows deleting role groups |
can_delete_storages |
Allows deleting storages |
can_delete_teams |
Allows deleting teams |
can_delete_themes |
Allows deleting portal themes |
can_delete_transcode_jobs |
Allows aborting a transcode job |
can_delete_transcoders |
Allows deleting a Transcoder |
can_delete_users |
Allows deleting users |
can_read_insights |
Allows seeing the reports on the Insights page |
can_delete_webhooks |
Allows deleting a Webhook definition |
can_edit_all_groups |
Allows editing all groups and adding users to them, regardless of ACLs (but not adding roles you don't have yourself) |
can_edit_all_groups_legacy |
On domains using teams and role groups, allows editing all legacy groups regardless of ACLs |
can_edit_all_role_groups |
Allows editing all role groups and adding users to them, regardless of ACLs (but not adding roles you don't have yourself) |
can_edit_all_teams |
Allows editing all teams and adding users to them, regardless of ACLs |
can_edit_all_users |
Allows editing all users, regardless of ACLs |
can_list_storage_files |
Allows listing storage files |
can_manage_all_shares |
Allows seeing, editing and deleting all users' shares |
can_purge_files |
Allows purging files |
can_purge_formats |
Allows purging formats |
can_read_acl_templates |
Gives access to ACL templates in the Admin view |
can_read_analysis_service_accounts |
Gives access to AI accounts in the Admin view |
can_read_apps |
Gives access to the Applications panel in the Admin view |
can_read_automations |
Gives access to the Automations page in the Admin view |
can_read_billing |
Gives access to billing |
can_read_cors_hosts |
Allows listing CORS entries for the API |
can_read_cuttingroom |
Allows opening the CuttingRoom projects linked to assets (Web UI only) |
can_read_groups |
Gives access to the group list in the Admin view |
can_read_groups_legacy |
On domains using teams and role groups, gives access to legacy groups |
can_read_logs_recipients |
Allows reading Shield logs recipients |
can_read_role_groups |
Gives access to the role group list in the Admin view |
can_read_stats |
Gives access to the Stats page |
can_read_system_domains |
Allows reading system domain info (only the current domain, unless a super admin gives wider access) |
can_read_teams |
Gives access to the team list in the Admin view |
can_read_themes |
Allows seeing portal themes |
can_read_transcoders |
Gives access to the Transcoder list in the Admin view |
can_read_users |
Gives access to the User list in the Admin view |
can_read_webhooks |
Gives access to Webhooks in the Admin view |
can_reindex_assets_history |
Allows reindexing asset history (API only) |
can_reindex_export_locations |
Allows reindexing export locations (API only) |
can_reindex_groups |
Allows reindexing groups (API only) |
can_reindex_metadata_views |
Allows explicit reindex of metadata views |
can_reindex_saved_searches |
Allows reindexing saved searches (API only) |
can_reindex_shares |
Allows explicit reindex of shares |
can_reindex_storages |
Allows reindexing storages (API only) |
can_reindex_transcoders |
Allows reindexing transcoders (API only) |
can_reindex_users |
Allows reindexing users (API only) |
can_run_automations |
Allows running an automation manually |
can_scan_bucket |
Allows scanning a cloud bucket for new content |
can_write_acl_templates |
Allows editing ACL templates |
can_write_analysis_profiles |
Allows editing AI analysis profiles |
can_write_analysis_service_accounts |
Allows editing AI analysis service accounts |
can_write_apps |
Allows creating new Applications and tokens |
can_write_asset_relation_types |
Allows adding relation types |
can_write_assets_history |
Allows updating Asset History entries |
can_write_automations |
Allows creating and editing automations |
can_write_billing |
Allows updating billing information |
can_write_cors_hosts |
Allows editing CORS entries for the API |
can_write_cuttingroom |
Allows creating and editing CuttingRoom projects from Iconik (Web UI only) |
can_write_drm_settings |
Allows turning on DRM protection when creating or editing a share |
can_write_export_locations |
Allows creating and editing Export Locations |
can_write_group_mappings |
Allows editing group mappings (SAML) |
can_write_groups |
Allows creating and editing groups |
can_write_identity_providers |
Allows editing the identity provider (SAML) |
can_write_logs_recipients |
Allows editing Shield logs recipients |
can_write_metadata_categories |
Allows editing Metadata Categories |
can_write_metadata_fields |
Allows creating and editing metadata fields |
can_write_metadata_views |
Allows creating and editing metadata views |
can_write_role_groups |
Allows creating and editing role groups |
can_write_storages |
Allows creating and editing storages |
can_write_teams |
Allows creating and editing teams |
can_write_themes |
Allows creating and editing portal themes |
can_write_transcoders |
Allows creating and editing Transcoders |
can_write_users |
Allows editing Users |
can_write_watermark_settings |
Allows turning on forensic watermarking when creating or editing a share |
can_write_webhooks |
Allows creating and editing Webhooks |
Domain Owner Role
Domain Owner is a special user setting, not a role. Domain Owners have access to all functions and content in the system, whatever their roles and ACLs.
Some Admin screens are only available to Domain Owners, whatever roles a user has: Preferences (including DRM and Watermark Settings), Custom Actions, Identity Providers, Themes and Logos.