Previous Next JavaScript must be enabled to correctly display this content

## 11.3.6.1 Managing Global Template Options

Gobal template options are defined at the theme-level.

Tip:

In order to add or edit template options, you must be the theme owner. See Unsubscribing to a Theme.

- Creating Global Template Options
  Define global template options on the Themes page under Template Options.
- Editing Global Template Options
  Edit existing global template options on the Themes page under Template Options.
- Managing Global Template Option Groups
  Define the purpose of related template options by creating template option groups. Examples of template option groups include Button Size, Button Style, List Examples, List Style, and Form Label Position.

Related Topics

- About Template Options

Parent topic: Using Template Options

### 11.3.6.1.1 Creating Global Template Options

Define global template options on the Themes page under Template Options.

To create a global template option:

1. Navigate to the Themes page:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Click Shared Components.
   4. Under User Interface, select Themes.
   The Themes page appears.
2. Select a theme.
3. Locate Template Options and click Add Template Option.
   A new row appears.
4. Edit the attributes:
   1. Template Type - Select the type of template for which the template option is defined.
   2. Group - Select a group name. Group names enable you to group template options and avoid the selection of conflicting option. See Managing Global Template Option Groups.
   3. Name - Enter a name for the template option.
   4. Identifier - Enter an alphanumeric, upper case identifier for the template option. Identifiers map a template option to a corresponding template option when switching themes.
   5. Sequence - Specify the sequence for this option.
   6. Classes - Enter one or more CSS classes that define this template option.
   7. Help Text - Enter a description of the template option.
   8. Static ID - Enter a unique Static ID to identify this component in API calls or refer to it in application export files.
5. Click Save.

Parent topic: Managing Global Template Options

### 11.3.6.1.2 Editing Global Template Options

Edit existing global template options on the Themes page under Template Options.

To edit a global template option:

1. Navigate to the Themes page:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Click Shared Components.
   4. Under User Interface, select Themes.
   The Themes page appears.
2. Select a theme.
3. Locate Template Options.
4. To edit a template option:
   1. Select the row containing the template option.
      The row becomes hightlighted.
   2. Edit the appropriate attributes.
      - Template Type - Select the type of template for which the template option is defined.
      - Group - Select a group name. Group names enable you to group template options and avoid the selection of conflicting option. See Managing Global Template Option Groups.
      - Name - The name for the template option.
      - Identifier - An alphanumeric, upper case identifier for the template option. Identifiers map a template option to a corresponding template option when switching themes.
      - Sequence - Specify the sequence for this option.
      - Classes - Enter one or more CSS classes that define this template option.
      - Help Text - Enter a description of the template option.
      - Static ID - Enter a unique Static ID to identify this component in API calls or refer to it in application export files.

      WARNING:

      If you edit the name of a CSS class, all components that reference that CSS class name must be updated manually. The Option Identifier cannot be modified since it is needed for mapping purposes.

   3. Click Save.
5. To delete a template option:
   - Click the Row Actions menu and select Delete Row.

   Tip:

   To learn more about the Row Actions menu, see About the Row Actions Menu in an Interactive Grid in Oracle APEX End User’s Guide

Parent topic: Managing Global Template Options

### 11.3.6.1.3 Managing Global Template Option Groups

Define the purpose of related template options by creating template option groups. Examples of template option groups include Button Size, Button Style, List Examples, List Style, and Form Label Position.

Tip:

In order to add or edit template option groups, you must be the theme owner. See Unsubscribing to a Theme.

- Creating a Global Template Option Group
  Global template option groups are defined at the theme-level and are available for all components of a given type.
- Editing Global Template Option Groups
  Edit global template option groups by navigating to the Themes page.

Related Topics

- About Template Option Groups and Presets
- Understanding Template Options

Parent topic: Managing Global Template Options

#### 11.3.6.1.3.1 Creating a Global Template Option Group

Global template option groups are defined at the theme-level and are available for all components of a given type.

When developers create a template option group, they can specify a template option preset at the template-level. For example, suppose you have a button template that has the template options Large and Small. If you define Small as the preset, then any new button referencing the template would automatically have the template option Small applied to it when is it created. Template options that are part of a group are optional unless defined at the template-level.

To create a global template option group:

1. Navigate to the Themes page:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Click Shared Components.
   4. Under User Interface, select Themes.
   The Themes page appears.
2. Select a theme.
3. Locate Template Options and click Template Options Groups.
   The Template Options Groups window appears.
4. To create a new group:
   1. Click Add Template Option Group.
      A new row appears.
   2. Edit the appropriate attributes:
      - Template Type - Specify the type of template for this template option group.
      - Name - Enter a display name for the template option group.
      - Identifier - Defines the internal name of the template option group.
      - Sequence - Specify the sequence for this template option group.
      - Null Text - Default value for the template option group if a user does not select any template option in that group.
      - Help Text - Enter a description of the template option group.
      - Advanced - Determines if the template option group belongs in the Basic or Advanced category of template options. Select Yes or No.
      - Static ID - Enter a unique Static ID to identify this component in API calls or refer to it in application export files.
   3. Click Save.

Parent topic: Managing Global Template Option Groups

#### 11.3.6.1.3.2 Editing Global Template Option Groups

Edit global template option groups by navigating to the Themes page.

To edit global template option groups:

1. Navigate to the Themes page:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Click Shared Components.
   4. Under User Interface, select Themes.
   The Themes page appears.
2. Select a theme.
3. Locate Template Options.
4. Click Add Template Option Groups.
   Template Options Groups dialog appears.
5. To edit a template option group:
   1. Select the row containing the template option group.
      The row becomes hightlighted.
   2. Edit the appropriate attributes.
      - Template Type - Specifies the type of template for this template option group.
      - Name - Dsplay name for the template option group.
      - Identifier - Defines the internal name of the template option group.
      - Sequence - Specify the sequence for this template option group.
      - Null Text - Default value for the template option group if a user does not select any template option in that group.
      - Help Text - Enter a description of the template option group.
      - Advanced - Determines if the template option group belongs in the Basic or Advanced category of template options. Select Yes or No.
      - Static ID - Enter a unique Static ID to identify this component in API calls or refer to it in application export files.
   3. Click Save.
6. To delete a template option group:
   - Click the Row Actions menu and select Delete Row.

   Tip:

   To learn more about the Row Actions menu, see About the Row Actions Menu in an Interactive Grid in Oracle APEX End User’s Guide

Parent topic: Managing Global Template Option Groups