# Create and manage a DPA

{% hint style="info" %}
This feature requires a Vendor Hub subscription with Openli.\
\
Contact <hello@openli.com> or visit our [website](https://openli.com/products/vendors) for more information on the Vendor Hub product
{% endhint %}

### How to Create an Agreement.

The first thing you need to do is create an agreement. In the Openli app, an agreement is simply a document, which you can update and manage from one place. Each agreement has a Public Key, which allows you to refer to and embed the policy in it's latest revision, making sure that when you update it in Openli, it is also updated all the places you have embedded it.

To get started with you DPA agreement, you need to go to [your openli app](https://app.openli.com).\
Find the agreements section in the side menu on the left. \
\
Click the *New agreement* button in the top right corner and choose *Data Processing Agreement* In the drop down.

![](https://1919043541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LRMQvUsiQMLNstTU-cS%2Fuploads%2FOmYQm4fEYwHvimwD6dmU%2FScreenshot%202021-12-17%20at%2014.34.57.png?alt=media\&token=ee715b7a-488d-4661-9742-9c0915d1db73)

This takes you to the document editor. \
Here you can insert your DPA or use tags as explained further down in this guide.\
Once you are done click *Preview*

![](https://1919043541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LRMQvUsiQMLNstTU-cS%2Fuploads%2F4kiW012TSNIikqwn17P1%2FScreenshot%202021-12-17%20at%2014.46.11.png?alt=media\&token=880bd655-f03a-4e39-b501-1ab38ac94f17)

This takes you to the preview page. Here you can see how it including any info pulled in via *tags.* If you want to edit more, click *edit.* Otherwise click *publish* to publish the agreement making it available for embedding.

![](https://1919043541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LRMQvUsiQMLNstTU-cS%2Fuploads%2FGAleQ3bjoQMWr2tQOXWd%2FScreenshot%202021-12-17%20at%2014.46.20.png?alt=media\&token=7cda7bf4-aa02-417f-95fe-e40cf5a37097)

Once published you can find it in your agreements section with all your other policies.\
Note that you can always find the agreements public key in this list as well.

![](https://1919043541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LRMQvUsiQMLNstTU-cS%2Fuploads%2FsrQgVcXxaZKg13qKfPEB%2FScreenshot%202021-12-17%20at%2014.53.36.png?alt=media\&token=1b407651-fc56-4c48-ac56-8cedc6fcb4a2)

### Using tags to embed lists of Subprocessors and Personal Data information.

Openli allows you to pull lists of your subprocessors and lists of the personal data you process into your DPA.

These lists can be limited just to one of your services or they can cover all the services you offer.\
\
Simply add the tags listed below in your policy where you want the list to appear and save it. \
\
Currently there are four tags available:

<table><thead><tr><th width="445"></th><th></th></tr></thead><tbody><tr><td>Tags</td><td>Result</td></tr><tr><td><code>{{ </code><em><code>service_name</code></em><code>.subprocessors_list }}</code></td><td>Creates a list of subprocessors for the service you have specified; the "service_name" part varies.</td></tr><tr><td><code>{{ </code><em><code>service_name</code></em><code>.personal_data_list }}</code></td><td>Creates a list of the data processed by the service you have specified; the "service_name" part varies.</td></tr><tr><td><code>[[LIST_SUBPROCESSORS]]</code></td><td>Creates a list of the subprocessors for all your services</td></tr><tr><td><code>[[LIST_PERSONALDATA]]</code></td><td>Creates a list of the data processed by all your services</td></tr></tbody></table>

The tags for specific services you offer can be accessed via a dropdown:

<figure><img src="https://1919043541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LRMQvUsiQMLNstTU-cS%2Fuploads%2FBQmIOuNcFL7cdNuqVc7m%2FScreenshot%202023-08-03%20at%2016.29.39.png?alt=media&#x26;token=cff23997-89e5-4189-bfb9-d79b7da789f7" alt=""><figcaption></figcaption></figure>

The "service\_name" in the tag will be a simplified version of your service's name. For example, "Openli Vendor Hub" would appear in the tag as "openli\_vendor\_hub".

If you would like to create lists for all your services you can use the tags as shown below:

![](https://1919043541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LRMQvUsiQMLNstTU-cS%2Fuploads%2FiYIGQaBZU2JSQVpNxfAQ%2FScreenshot%202021-12-17%20at%2015.06.45.png?alt=media\&token=6e2470f1-a5c9-4117-a531-4117ab6fd4de)

### Editing your Agreement

Once you have an agreement up and running, you can edit it if any changes should be necessary.\
\
To do so go to *agreements* to find you list of policies. \
\
Then click the name of the policy.&#x20;

![](https://1919043541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LRMQvUsiQMLNstTU-cS%2Fuploads%2FR1ebI8djZcGUa05AoQ8F%2FScreenshot%202021-12-20%20at%2014.18.31.png?alt=media\&token=39cd461a-14ba-42dd-beeb-d7a87335c536)

Once here you can see a list of the previous drafts, and in the very top you'll find the current version. Click *update* next to the current version.

![](https://1919043541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LRMQvUsiQMLNstTU-cS%2Fuploads%2F2JFV2FzszTVR5LS64OsN%2FScreenshot%202021-12-20%20at%2014.19.49.png?alt=media\&token=bafa41ec-a8fe-45f5-acdf-cac5c453b471)

Now you'll be in the agreement editor, where you can update the agreement to you needs. When you're done click *preview* to preview the edits.

![](https://1919043541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LRMQvUsiQMLNstTU-cS%2Fuploads%2FO38YwQUFeRa7NHZrW5fA%2FScreenshot%202021-12-20%20at%2014.27.20.png?alt=media\&token=d6b2f44a-46df-4214-99dd-37e1d8030c6e)

If you are happy with the changes you see in the preview, you click *publish*, and your DPA is now updated with your latest changes.&#x20;

![](https://1919043541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LRMQvUsiQMLNstTU-cS%2Fuploads%2F84QKAS2ZAEnfJA7gzoV3%2FScreenshot%202021-12-20%20at%2014.20.22.png?alt=media\&token=840b7736-bb53-4ac3-ac59-8cda4b19e4b5)

Remember that you can always return ti the agreements revision page to see all revisions you have made.

### Embedding Agreements

To Embed agreements you need to follow this guide if you are already using our cookie widget:

{% content-ref url="../policy-and-agreement-management/embed-your-policies-and-legal-agreements" %}
[embed-your-policies-and-legal-agreements](https://docs.openli.com/docs/policy-and-agreement-management/embed-your-policies-and-legal-agreements)
{% endcontent-ref %}

If you do not have a widget live on your website you need to follow this guide in stead:

{% content-ref url="../policy-and-agreement-management/embed-your-policies-and-legal-agreements/embedding-agreements-without-displaying-a-widget" %}
[embedding-agreements-without-displaying-a-widget](https://docs.openli.com/docs/policy-and-agreement-management/embed-your-policies-and-legal-agreements/embedding-agreements-without-displaying-a-widget)
{% endcontent-ref %}