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

# Manage symbol libraries

> Create and modify symbol libraries to add new symbols or geometries for diagram parsing in Cognite Data Fusion (CDF).

<Note>
  Symbol library management is part of **Full diagram parsing**, which is currently in [*public preview*](/cdf/product_feature_status) testing and is subject to change.
</Note>

## Add a symbol to a library

Symbol libraries are only applicable for **Full diagram parsing** workflows.

<Steps>
  <Step title="Navigate to Diagram parsing">
    Navigate to **Data fusion** > **Contextualize** > **Diagram parsing**.
  </Step>

  <Step title="Select or create a library">
    Select **Manage libraries** and then select the library to which you want to add the symbol. To create a symbol library:

    * To copy a template, select  a template and then select **⋮** > **Duplicate template**.

    * Select **+** to create a new library.
  </Step>

  <Step title="Add geometry to symbol">
    To add a **geometry** to an existing symbol, select the symbol and **Add as geometry**.

    <Info>
      For pipe detection, a line is identified as a pipe only if it has an endpoint touching at least one detected symbol. Adding more geometries of piping symbols does not affect the detection process. When you review the parsed output, adding lines as pipes will create additional detected pipes from the selected lines.
    </Info>

    <Warning>
      When you delete a **geometry** in **Manage libraries**, you remove one of the shapes the parser uses to recognize that symbol. The next time you parse, the parser only uses the geometries that are still on the symbol.
    </Warning>
  </Step>
</Steps>

## Delete a library or symbol

You can remove an entire library or delete individual symbols from **Manage libraries**.

When you delete a **symbol** or **library**, read the confirmation dialog first. It lists every **detection** (diagram match) that will be removed across **all** files that use the library, including files beyond the diagram you have open.

<Warning>
  Deletion is permanent. Confirm you accept the scope shown in the dialog, including changes in other files that use the library.
</Warning>
