Exclude one component from branching

When choosing which references in the source component to branch, you can hide a referenced component so it can't be included in the new branch. By attaching the ExcludeFromBranch tag, you only prevent a reference from being branched and not the source. The tag does not prevent a user from going to the Components browser and saving a component itself as a branch.

Restrictions

  • You must have Update permissions to the component to make tag changes. Tags are read-only for users without update permissions.
  • A content owner or administrator can set permissions to deny access to components or folders. If your permissions to content has been blocked and you are not an administrator, you cannot use the Details option in a project's Content pane.

Tips and tricks

  • Component tags are added to a component's Inspire metadata.
    • These tags cannot be added, updated or removed using the Oxygen editor.
    • These tags cannot be used to transform the XML during publishing.
    • These tags are not included in the XML when you export the component.
  • Inspire metadata tags are applied to an entire component and are not the same as XML tags used in the Oxygen editor. For help with XML tags, read: Show or hide tags in Oxygen.
  • Inspire provides the pre-defined tag ExcludeFromBranching. However, Administrators can customize tag names and availability.
  • After you save the tag, Inspire makes sure that the component can't be selected on the Save as a branch screen.
  • You can use this tag on binary components such as an image or PDF file.
  • You can also prevent project files from being branched.

To exclude multiple components from branching, read Exclude multiple components from branching.

To exclude a component from branching:

  1. Click Components.
  2. On the Components tab, select the component you want to prevent from being branched when it's referenced.
  3. Right-click the component name, and then select Details...
  4. On the Component Details dialog, select the Details tab.
  5. In Tags, select ExcludeFromBranch.

    If you don't see the option you need, contact your Administrator. You can only select a tag from the list if an Administrator allows the use it.

  6. On the Component Details dialog, click Save.
    Results:
    You see the component marked with the tag icon in the Components browser.

    Tips and tricks

    • Look in the 8th column after the initial checkbox.
    • If it exists, the tag icon appears after (the Shared icon) and before or (the file type icon).
    • To see the name of all tags that are applied, hover your cursor over the tag icon.
    • After you apply a tag, you must refresh the Components browser before the tag is displayed

    When another component is branched, if it references this component, the tag prevents this component from being listed as a reference and so can't be branched.
    For more details, refer to Prevent branched references.