# Recording a distribution's data lineage

Data lineage can be recorded for a distribution via its item editor, capturing what other distribution(s) the item may be informed by or have historically been a part of.

Distribution lineage can also be linked to any data elements that describe a column or field within a distribution via data element paths.

## How to record a distribution's source distribution(s)

1. Navigate to the desired distribution, and select 'Open item editor' from its 'Actions' dropdown.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FsuiUlc5YIrBkP8ReBNOi%2Fimage.png?alt=media&#x26;token=98ebacd1-ba5b-4649-ba8c-819d53995e6f" alt=""><figcaption></figcaption></figure>

2. Select the 'Components' tab.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FPiOZW97Pltovuk47rDl5%2Fimage.png?alt=media&#x26;token=a5d95d6c-295f-49bf-972a-3aa6c7f025ca" alt=""><figcaption></figcaption></figure>

3. Navigate to the 'Provenance' section, then select 'Add'.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FU73onOHEHPf2i6KaLMZt%2Fimage.png?alt=media&#x26;token=ffcd9840-18a6-4d86-aef6-3059020dc7f8" alt=""><figcaption></figcaption></figure>

4. Select the relevant source distribution(s) from the 'Source Distributions' dropdown.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2F7EIip01DmBE1GcsCjtrK%2Fimage.png?alt=media&#x26;token=d1644692-ea44-4dfd-943e-43b282350a32" alt=""><figcaption></figcaption></figure>

5. **If you wish to record the distribution's method of generation**, populate the 'Generation' field with the relevant method.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2Fmnm82PC6NOoyPa7Aj22W%2Fimage.png?alt=media&#x26;token=cd0ff220-c9c8-4138-8c0f-241de727057d" alt=""><figcaption></figcaption></figure>

6. **If you wish to record the distribution's release date**, do so using the 'Release Date' dropdown.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FQhgud8CT9EzMJtE3WvWT%2Fimage.png?alt=media&#x26;token=ed8b71a9-5f59-4bf3-a735-2cbd9ebdfbb1" alt=""><figcaption></figcaption></figure>

6. Select 'Save changes' once satisfied. The lineage details will be recorded on the distribution's item page.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FJijeBExTkU22oPn4wW8O%2Fimage.png?alt=media&#x26;token=0f022fb1-ce79-4082-a9bc-5b50b69ad5ce" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FCCAi3xpPndJCWBHNGqGS%2Fimage.png?alt=media&#x26;token=cd95d868-d3bd-49f4-9690-91504a37159d" alt=""><figcaption></figcaption></figure>

## How to record a distribution's data element path(s)

1. Navigate to the desired distribution, and select 'Open item editor' from its 'Actions' dropdown.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FsuiUlc5YIrBkP8ReBNOi%2Fimage.png?alt=media&#x26;token=98ebacd1-ba5b-4649-ba8c-819d53995e6f" alt=""><figcaption></figcaption></figure>

2. Select the 'Components' tab.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FPiOZW97Pltovuk47rDl5%2Fimage.png?alt=media&#x26;token=a5d95d6c-295f-49bf-972a-3aa6c7f025ca" alt=""><figcaption></figcaption></figure>

3. Navigate to the 'Data Element Path' section, then select 'Add'.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FD23NQnFLlvTTbpNIER4K%2Fimage.png?alt=media&#x26;token=ef9f8821-f9b2-4073-bdd1-1bd7291eddb6" alt=""><figcaption></figcaption></figure>

4. Select the relevant data element(s) from the 'Data Element' dropdown.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FOa2VcXacCdYQdF6u0FNJ%2Fimage.png?alt=media&#x26;token=a429c13b-981f-4a00-9f16-327bb6678de7" alt=""><figcaption></figcaption></figure>

5. **If you wish to assign this data element a physical data type**, do so using the 'Physical Data Type' dropdown. Physical data types describe the format that this data element takes within the distribution, such as 'Date'.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FqCdD6qfD00kncUqjZ2pJ%2Fimage.png?alt=media&#x26;token=f8cb7078-9116-4951-bd6c-acc7ff644f88" alt=""><figcaption></figcaption></figure>

6. **If you wish to describe the logical path between this data element and distribution**, do so using the 'Logical Path' field. Logical paths contextualise a data element's contribution to a distribution, and are often as simple as the title of a column of data.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FNr6ogF5IFMc4nUUvMASK%2Fimage.png?alt=media&#x26;token=db960e2e-b482-4212-9875-9f50c6854354" alt=""><figcaption></figcaption></figure>

7. **If you wish to list object classes that apply to this data element**, do so using the 'Specialisation Classes' field.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FdGdqV4NicAphOHgqDyN3%2Fimage.png?alt=media&#x26;token=3cf5d101-6f03-4844-abec-b533e96c0c59" alt=""><figcaption></figcaption></figure>

8. **If you wish to provide additional information about this data element's inclusion in the distribution**, do so via the 'Specific Information' field.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FlfDNaXdV8E9fo17s096r%2Fimage.png?alt=media&#x26;token=f7781e17-b3aa-4ee6-8bc4-63273ddefaae" alt=""><figcaption></figcaption></figure>

9. **If you wish to provide any information about this data element's lineage/transformation**, do so via the 'Lineage Details' field.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FoSNRshl6zPtWi2ISDSbi%2Fimage.png?alt=media&#x26;token=04ae2c2e-adf1-4055-9742-dca4b32a83e6" alt=""><figcaption></figcaption></figure>

10. **If you wish to list external data element paths that contributed to the calculation of this data element**, select a distribution from the 'Filter by distribution' dropdown, then a data element path from the 'Select path name' dropdown. Your selections will be added as a list below the selection fields.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FKXmrfPPf0cSfyoF2HWiR%2Fimage.png?alt=media&#x26;token=bbb3ee36-99eb-45f6-b16f-a2ce35f5bd0c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FMwgVCBtgyrQHy6RVUcZ6%2Fimage.png?alt=media&#x26;token=fe259bc1-8f59-409b-b53e-ce8ed8f5f48f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FOs92gLXAjRFdcrblm0I7%2Fimage.png?alt=media&#x26;token=e3bc007e-cd92-4512-9d72-56d41bc49b54" alt=""><figcaption></figcaption></figure>

11. Select 'Save changes' once satisfied. The data element path(s) will be recorded on the distribution's item page.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FmCr3ai0TP9fE96DkBSiF%2Fimage.png?alt=media&#x26;token=fa928570-dcba-4a7c-af8e-482b1c1f6669" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FyYArl8Dy8gEzXObGHLi8%2Fimage.png?alt=media&#x26;token=fbc75bb2-c821-40e5-986c-c26fe436efae" alt=""><figcaption></figcaption></figure>

**Note:** 'Toggle lineage information' can be selected to show or hide your configured lineage details and relationships (below).

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FyB1w28GlDB2qkV30isE3%2Fimage.png?alt=media&#x26;token=9dd2adbe-193f-4f4f-9e9a-991566dbfa57" alt=""><figcaption></figcaption></figure>
