Components

Components are containers for issues in Google Issue Tracker. A component may correspond to a project, sub-project or other functional or organizational group of issues.

Components can have child components, with all of the components in Issue Tracker comprising a component hierarchy. Generally, the hierarchy organizes components from most general to most specific. For example, a project whose issues are managed in Issue Tracker can have one top-level component and several nested sub-components, each of which organize issues into related groups.

A best practice for creating issues is to create them in the most specific component whose purpose matches the issue type. The appropriate component for any given issue varies by project.

Component properties

Components have the following properties:

Property	Example	Description
Name	Feedback	Name of the component. This is not necessarily unique across Issue Tracker.
ID	121405	Unique ID number for the component.
Description	Summary of information required to identify the component and its purpose.
Component Hierarchy	Sample Project > Sample Project Bugs	Hierarchy of the parent components down to the given component.
Child Components	UX Bugs, Latency Issues, Security	Components that are direct children of the given component.
Custom Fields	Sprint, ETA	Custom fields associated with the component. For more information, see Custom Fields.
Access Control	See Access Control	Specifies who can perform what actions in the component.
Templates	See the Template page	Specifies default or initial fields values for new issues filed in the component.

Component search

Issue Tracker displays the component search tool wherever you can specify a component in the user interface. When you enter keywords associated with the component path or description, the tool automatically initiates a component search and displays ranked search results in a drop-down list. The ranking is determined using a combination of text-match scoring and popularity.

If you search components using a string of numbers, Issue Tracker returns components that have the string in their name or description, as well as the specific component whose component ID matches the string.

The component search result shows matching components, as well as any child components. It also displays a description for the component if it exists.

To isolate a specific component within the displayed hierarchy and view its childen, click the Show Child Components button on the left side of the desired entry. (Note that this button is not available when using search bar or search editor.) When you click the button the component tree browser replaces the ranked search results.

As with the ranked search results, a description of each component appears below the component itself if it exists.

You can click the back button to return to the ranked search results.

Search for components

You can search for components when you perform the following tasks:

• Create a new issue.
• Edit the component field of a specific issue.
• Choose Component in the search builder.
• Enter componentID in the search bar or search editor.
• Select Component in the Edit drop-down of a bulk edit.
• Search by or display a custom field in an issue search.

When you search for a component in the search editor or search bar, you cannot choose to show child components when viewing search results. These features also convert any component name that you choose to a numerical ID for display.