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.

Learn more