See where a component is used

You can view all components that reference the selected component from the Where Used tab. For example, the selected component might be referenced from a map, a cross-reference, or a content reference. This is helpful if you want to delete a component but need to see if any other components link to it first.

To see where a component is used:

  1. Click Components_TopMenuOpt Components.
  2. In the Folders pane, navigate to the folder where you've saved the component.
  3. In the Components pane, select the component you want to open.
    Note: You can verify you have the correct component by looking in the Content details pane at the preview. 

    If the pane isn't open, click the down arrow in the pane's title bar.

    If you think the preview isn't showing the latest version, click Refresh .

  4. Right-click a component, and then click Details...
    Note: You can also access this option from the component's Options menu.
  5. On the Components Details dialog, click the Where Used tab.
  6. If the number of references is large, to find a reference:
    • Sort the list by selecting a column title.

      You can now sort the data by the Lock column.

      • You can click the Lock column heading.
      • You see an up or down arrow to indicate if the list is sorted in ascending or descending order.
    • Filter the list by words in the component name by entering text in the Search text box and clicking Search search_button.
    • See more details by adding other columns to the list.
    • Limit the number of references in the list using filtering options.
    • Move to the next or previous page in the list using the page navigation options at the bottom of the list.
  7. Optionally, you can:
    1. To save the list of components that reference the selected component to a CSV file:

      You can filter the list of components before saving the list to a CSV file.

      • In the Search field, enter key words.
      • In Saved Queries, select a query.
      1. Click Save as CSV ExportCSV.
      2. To choose what time zone is used, on the Convert time confirmation screen, select one of the following:

        You see the date displayed in the header of the CSV as: All date/times are shown in {timezone} or UTC.

        UTC is a time zone standard used as a basis for all time zones worldwide. It is a constant time scale and does not change for Daylight Saving Time.

        • To use your local time, click Yes.
        • To use UTC time, click No.
    2. To open a reference in the Oxygen-based editor, select the reference's Options menu, and then click Edit.
    3. To open a reference in a read-only viewer, select the reference's Options menu, and then click View.
    4. To locate the folder where the component is saved in the Components browser, select the reference's Options menu, and then click Go to.
  8. On the Where Used tab, you can see information about the link, such as if it's valid, in the References panel.
    1. In the first grid, select a component.
    2. If you don't see it, to expand the References panel, click the up arrow.
    3. By default, you can see information about the Target name, reference Type, Id, and Status.
    4. Optionally, you can click a column title, select the menu arrow, select Columns, and show or hide any of the following: Target, Target Path, Source, Source Path, Type, Id, File Name, Source Element Name, Source Attribute Name, Source Attribute Value, Target Element Name, Target Attribute Name, Target Attribute Value, Status, Word Count.
    5. Optionally, you can sort the list of references by clicking a column title. The up or down arrow next to the column name tells you if it's sorted ascending or descending.
  9. If you made changes, on the Component Details dialog, click Save.
  10. To close the Component Details dialog, click Cancel.