> For the complete documentation index, see [llms.txt](https://docs.decube.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decube.io/lineage/manual-lineage.md).
# Add lineage relationships manually
Close the gaps on lineage graphs through the UI or API.
Lineage relationships can be added manually through the platform for situations where the automated parser is unable to pick up the lineage during metadata ingestion (e.g., highly customized data workflows).
{% hint style="info" %}
This document explains how to add lineage relationships through the UI. To use the API, refer here [Lineage](/public-api/overview/index/lineage.md).
{% endhint %}
When lineage relationships are updated manually, they will appear on the canvas just like automated lineage. However, clicking the connection line will show in the Connection details that the lineage was derived from a manual addition, including who added the relationship and when it was added.
### How to update manual lineage relationships
{% hint style="info" %}
**Note:** You can only add manual lineage directly to your **Entry Point Asset** (the primary asset you navigated to from the Catalog).
{% endhint %}
1. **Initiate the Change** On the Lineage tab of your Entry Point Asset, click the Make Changes button in the top right corner.
2\. **Select the Direction** Once clicked, the lineage canvas will automatically reset and isolate your Entry Point Asset, temporarily hiding all other nodes. The canvas interactions will be disabled to help you focus, and Add upstream and Add downstream buttons will appear on either side of the node.
* Click the appropriate button depending on where the data is coming from (upstream) or going to (downstream).
3. **Choose the Asset** A modal will appear. First, select the Data Source where the asset resides, then search for and select the specific Data Asset you want to connect.
4. **Map Columns (Optional)** If you want to create a highly specific trace, click on Map Columns to define the exact column-to-column relationships between the two assets.
Once you complete the workflow in the modal, the lineage canvas will refresh to show your Entry Point Asset connected to the newly added manual node.
Added nodes will be shown highlighted in yellow.
5. **Click submit to save your changes.** Your manual lineage addition will be submitted as a change request and will become permanently visible on the graph once approved.
### Removing existing manual lineage relationships
To remove manual lineages that were added in previous change requests, you will need to click on **Make Changes** on the asset.
1. Existing manual lineage relationships linked to the Entry point asset will be displayed with `Delete manual lineage` buttons.
Existing manually lineage relationships will be shown in the change request for editing.
2. Click on `Delete manual lineage` button on the node to be removed. You may undo the the deletion by clicking on the `Undo delete` button.
3. Click submit to save your changes. Your manual lineage deletion will be submitted as a change request and will become permanently removed from the graph once approved.
{% hint style="warning" %}
If you have multiple columns linked to the lineage node that has been manually added, removing the node will de-link all the relationships related to that node. You will need to re-add all the column-to-column links in a new change request.
{% endhint %}
