> ## Documentation Index
> Fetch the complete documentation index at: https://confidence.spotify.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage metric collections

> Learn how to create metric collections, add metrics, and manage access in Confidence.

export const HowToSchema = ({name, description, steps = []}) => {
  const schema = {
    "@context": "https://schema.org",
    "@type": "HowTo",
    name,
    description
  };
  if (steps.length > 0) {
    schema.step = steps.map((s, i) => ({
      "@type": "HowToStep",
      position: i + 1,
      name: typeof s === "string" ? s : s.name,
      text: typeof s === "string" ? s : s.text || s.name
    }));
  }
  return <script type="application/ld+json" dangerouslySetInnerHTML={{
    __html: JSON.stringify(schema)
  }} />;
};

<HowToSchema
  name="Manage metric collections"
  description="Learn how to create metric collections, add metrics, and manage access in Confidence."
  steps={[
{
  name: "Navigate to the Collections page",
  text: "Go to Admin > Collections in the sidebar navigation.",
},
{
  name: "Click Create",
  text: "Click the Create button in the top right corner.",
},
{
  name: "Enter collection details",
  text: "Fill in the display name, optional description, and select an owner for the collection.",
},
{
  name: "Save the collection",
  text: "Click Create to save the collection.",
},
{
  name: "Open a metric detail page",
  text: "Navigate to the metric you want to add or remove.",
},
{
  name: "Open the Add to collection dialog",
  text: "Click the Add to collection button in the page header.",
},
{
  name: "Select collections",
  text: "Check the collections you want to add the metric to, or clear to remove it.",
},
{
  name: "Save changes",
  text: "Click Save to apply your changes.",
},
]}
/>

[Metric collections](/docs/collections/metric-collections) let you group related metrics into
shared, team-visible lists. This guide covers creating collections, managing their contents,
and configuring permissions.

## Create a metric collection

<Steps>
  <Step title="Go to the Collections page">
    Go to **Admin** > **Collections** in the sidebar navigation.
  </Step>

  <Step title="Click Create">
    Select **Create** in the top right corner.
  </Step>

  <Step title="Enter collection details">
    Fill in the form:

    * **Display name**: A descriptive name for the collection (for example, "Q3 Launch Metrics")
    * **Description**: Optional explanation of what this collection contains
    * **Owner**: The user or group that owns this collection
  </Step>

  <Step title="Save the collection">
    Click **Create** to save the collection.
  </Step>
</Steps>

## Add or remove a metric from a collection

<Steps>
  <Step title="Open a metric detail page">
    Go to the metric you want to add or remove.
  </Step>

  <Step title="Open the Add to collection dialog">
    Select **Add to collection** in the page header.
  </Step>

  <Step title="Select collections">
    Search for collections by name and check the ones you want to add the metric to.
    Clear a collection to remove the metric from it.
  </Step>

  <Step title="Save changes">
    Click **Save** to apply your changes.
  </Step>
</Steps>

You can also remove a metric from within the collection page by clicking the **delete icon** next
to the metric and confirming the removal.

## Filter metrics by collection

The collection filter is available on the Metrics list page and in the metrics picker when
adding metrics to an experiment.

<Steps>
  <Step title="Open the Metrics list or metrics picker">
    Go to the Metrics list page, or open the metrics picker when configuring an experiment.
  </Step>

  <Step title="Add a collection filter">
    Open the filter sidebar and select **Collection** from the filter options.
  </Step>

  <Step title="Select a collection">
    Search for and select the collection you want to filter by.
  </Step>
</Steps>

## Edit a collection

<Steps>
  <Step title="Open the collection">
    Go to **Admin** > **Collections** and click the collection.
  </Step>

  <Step title="Edit details">
    In the sidebar, select **edit** in the About section to change the display name,
    description, or owner.
  </Step>

  <Step title="Save changes">
    Click **Save** to apply your changes.
  </Step>
</Steps>

## Delete a collection

<Steps>
  <Step title="Open the collection">
    Go to **Admin** > **Collections** and click the collection.
  </Step>

  <Step title="Delete the collection">
    In the sidebar, click **Delete** and confirm the deletion.
  </Step>
</Steps>

<Note>
  Deleting a collection does not delete the metrics it contains. It only removes the grouping.
</Note>

## Manage Collection Permissions

<Steps>
  <Step title="Open the collection">
    Go to **Admin** > **Collections** and click the collection.
  </Step>

  <Step title="Open permissions">
    Select **Permissions** in the page header.
  </Step>

  <Step title="Configure access">
    Add users or groups and assign their roles. Click **Save** to apply.
  </Step>
</Steps>

## Related Resources

<CardGroup cols={2}>
  <Card title="Metric collections" href="/docs/collections/metric-collections">
    Learn about metric collections
  </Card>

  <Card title="Metrics" href="/docs/metrics/introduction">
    Learn about metrics in Confidence
  </Card>

  <Card title="Manage labels" href="/docs/how-to-guides/manage-labels">
    Organize resources with custom tags
  </Card>
</CardGroup>