Object management

Amplitude's object management feature lets you centrally manage analysis objects. Analysis objects are the reusable building blocks of your analyses, including custom events, metrics, and segments.

With object management, you can:

• Create and update analysis objects.
• Remove duplicate analysis objects.
• View an analysis object's definition, and the charts it's used in.
• Bulk delete analysis objects.

Common use cases

• Look for similar metrics, custom events, or segments during object creation to decide if any existing objects work, instead of creating another duplicate.
• Use the metadata (for example, sorting by L30D query volume) to identify the most underutilized objects and remove them from the system.
• Filter by object owner to find your own content quickly, or find objects created by experts and power users in your organization.
• Admins can designate metrics, custom events, segments, and cohorts as "official," so users know which objects are safe to use.

Manage your analysis objects

Access Object Management from the left nav.

From the Object Management page, click + Create New and select the type of object you want to create. Follow the prompts in the modal that appears (it's different for each type).

As you define the object (by adding events for custom events and metrics, or by specifying users to include in your cohorts or segments), Amplitude Analytics shows you a list of similar objects at the bottom of the modal. Check your new object against this list to avoid creating unnecessary duplicate objects.

Designate the object as "official" by clicking the checkmark next to the title. Designating the object validates it for use in charts and analyses, and Amplitude Analytics considers it to be a source of truth.

After you create an analysis object, edit it by clicking its name in the list. The object's drawer opens. Click Edit.

To find which charts a metric or custom event appears in, click the Charts tab.

To create a new chart from an analysis object, click Open in Chart from within the object's drawer. You can change the chart type if needed.

To duplicate, delete, or copy a link to the analysis object, click ... and select the appropriate choice from the dropdown.

To bulk-delete analysis objects, navigate to the appropriate tab (Custom Events, Metrics, Segments, or Cohorts) and click the checkboxes of each object you want to delete. Then click Delete.

Permissions

Amplitude users with the Organization-level role of Member or higher can create analysis objects, and update or delete analysis objects they own. Only administrators can delete objects created by anyone. Object management doesn't support permissions at the project level.