---
sourceDocument: Xanadu Customer Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/customer-service-management

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu Customer Service Management

ft:clusterId :

    - csm

bundleId :

    - csm

workflow :

    - Customer and Industry


---

# Create an OpenFrame configuration

# Create an OpenFrame configuration {#ariaid-title1}

* Release version: Xanadu
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

This configuration specifies the OpenFrame window settings as well as the URL to be
launched within OpenFrame.

## Before you begin

Role required: admin

## About this task

As part of the OpenFrame configuration, users with the admin role can select one or more user groups. Access to the configuration is limited to the users that have the OpenFrame user role and that belong to the selected
groups.

## Procedure

1. Navigate to AllOpenFrameConfigurations to display the OpenFrame Configurations list.
2. Select New.
3. Fill in the fields, as appropriate.  
   {#t_CreateAnOpenFrameConfiguration__table_ctq_1706_ae__entry__2}

   | Field | Description |
   |-|-|
   | Name | The name of the OpenFrame configuration. |
   | Title | The title that appears in the OpenFrame window header. |
   | Subtitle | The subtitle that appears in the OpenFrame window header. |
   | Order | The order number for the configuration. If users have multiple OpenFrame configurations, they can only access the configuration with the lowest order number. Note: When upgrading, the Order field for the existing default OpenFrame configuration is set to 1. |
   | Enable collapsed view | Enables the expand and collapse capability for the OpenFrame window. When collapsed, users can still access call control actions. The default setting is False. |
   | Show presence indicator | Enables the indicator that displays agent availability. |
   | User Group | The user groups selected for this configuration. Access to this configuration is limited to the users that have the OpenFrame user role and that belong to the selected groups. Note: If you do not select any groups, the configuration is available to all users with the OpenFrame user role. |
   | URL | The URL to be launched within OpenFrame. This URL can be an absolute path or a path that is relative to the ServiceNow instance. |
   | Active | Denotes this configuration as active. |
   | Width | The width of the OpenFrame window. |
   | Height | The height of the OpenFrame window, not including the OpenFrame header height. |
   | Icon Class | The class of icons used for the OpenFrame window (retina-icons.css). Only supports icon-phone and icon-video values. |
   | Title Icon | The icon displayed on the OpenFrame window header. |
   | Configuration | Can be used to store any JSON-encoded string. |
   [Table 1. OpenFrame Configuration form]

   {#t_CreateAnOpenFrameConfiguration__table_ctq_1706_ae}  
   Note:  
   Several fields on the OpenFrame Configuration form can also be set by using the OpenFrame API. These fields include: Title, Subtitle, Width, Height, and Title Icon.
4. Select Submit.
**Related topics**   

* [openFrameAPI - Client](https://www.servicenow.com/docs/access?context=c_openFrameAPI&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US)

*[\>]: and then