CMS 10.6 Editing Embedded Components via In-Context Editing


Users can edit embedded components within list item content trays via In-Context Editing (ICE) mode. Use ICE to navigate directly to the original component's xID.

Note

If fields contain referenced content instead of embedded content, see CMS 10.6 Editing Existing Components via In-Context Editing for details to edit the referenced field content.

See CMS 10.6 ICE Content Trays for details about embedded content vs. referenced content.

Users can make changes to embedded component content in page fields structures.

For embedded component content, editing options include:

  • Edit embedded component fields. Change the field values of the currently embedded component unit.
  • Save embedded component to a new xID. Save the embedded component unit as a separate component item within Site > Site Tree. This option assigns a new xID to the component, and the list item references the component item rather than embedding the content.
  • Save embedded component to an existing xID. If the embedded component unit was previously referenced, users can save the embedded content unit and any new changes to the original component item within Site > Site Tree. This option references the original component xID and adds any changes made while the content was embedded to the component. The list item references the component item rather than embedding the content.
To edit embedded components via ICE:
  1. Access ICE mode. See Accessing ICE Mode for details.
  2. Select the header of the referenced component you want to edit within the Edit tab workspace.
    Tip
    For components nested within list elements, the list element icon List Element Icon indicates where a list starts within the page fields structure. A gear icon Component Element Icon displays in the header of list items that contain component content.
  3. Choose the step that suits your needs.
    Note
    If the header toolbar options don't initially display, then select the Show Actions vertical ellipses (...) icon to access them.
    • Edit the currently embedded component content, and then apply your changes.
      • You can the Edit in fieldEdit in Field Icon icon in the header toolbar, and make changes to the component's field elements in the dialog.

        See Completing Page and Component Elements for details to make changes the component's field elements you want to edit.

        Edit This Field In-Context Dialog

      • For field types such as plain text and XHTML editor, you can make edits directly to the inline field within the embedded component.

        Inline Editable Plain Text Field

    • Convert the currently embedded component content to a new component item with an xID.
      1. Select Save > Save new component in the header toolbar.

        If the embedded content correlates with a pre-existing component, the Component Sharing dialog displays.

      2. If the Component Sharing dialog displays, select Create New.

        The Select parent page for component sharing dialog displays.

        Select Parent Page for Component Sharing Dialog

      3. Search for and select a parent folder, page, or component based on the item's friendly name or xID in the provided field.
        Note
        This content item serves as the parent of the new component xID.
      4. Click Select.

        The embedded content converts to a new component item. The system creates the component under the selected parent in Site > Tree, and the content tray placement references the new component's xID.

      5. Optional: See CMS 10.6 Editing Existing Components via In-Context Editing for details to make changes to existing component item references.
    • Convert the currently embedded component content to a pre-existing component item, and update the component with any changes made while the content was embedded.
      1. Select Save > Save new component in the header toolbar.

        The Component Sharing dialog displays.

      2. Select Update Original.
        Troubleshooting
        The system only completes the update when you have the original component checked out and assigned to you with full access security permissions. If you don't know the xID of the correlating component, review the Alert message that displays in the interface after selecting Update Original.

        The embedded content converts to the existing component item. If any changes were made while the content was embedded, the system adds the content changes to the component. The content tray placement references the existing component's xID.

      3. Optional: See CMS 10.6 Editing Existing Components via In-Context Editing for details to make changes to existing component item references.
  4. Select Save in the Edit tab toolbar to save your ICE changes.
    Warning
    Always save after making ICE changes. Otherwise, the system will not preserve your new changes.

Next Steps (optional): If a list element contains list items with embedded components, see CMS 10.6 ICE List Elements for details to add, replace, remove, or reorder the list items.