---
title: "How to include a privacy policy"
source: https://dev.pageseeder.com/get_started/tutorials/how_to_include_a_privacy_agreement.html
last_updated: 2026-08-07T17:09:54+10:00
tokens: ~972
---

# How to include a privacy policy

| Property | Value |
| --- | --- |
| Skills required | XML, Markdown |
| Time required (minutes) | 15 |
| Intended audience | Developer |
| Difficulty | Easy |
| Category | Document |

## Objective

In this tutorial, you’ll learn how to configure PageSeeder to display your privacy policy both in the user interface and during the sign-up process.

Many organizations require users to be informed about how their personal data is handled. This is typically achieved through a privacy agreement or policy that users must review, and it should be readily accessible within the application.

## Prerequisite

- You are a system administrator
- You have a PageSeeder developer license or a service provider licence
- PageSeeder is configured to use a global template – See [How to set up a global template](how_to_set_up_a_global_template.md)
- You have a copy of the privacy policy in electronic format if you want to use your own policy

## Tutorial

In the following steps, we modify the organization config in the global template to include a privacy policy and configure it to ensure it is available on sign up.

### Pages in this tutorial

You will need to go to the **Organization settings** page:

1. Go to the tools **Administration dashboard**
2. Select to the cog **System configuration \> ****Organization settings** from the side-menu

You can reach the **Templates file** page from the **Organization settings** page, or by going to

1. Go to the wrench **Project administration**
2. Select the template **Template \> Template files** from the side-menu

### Upload your privacy policy

In this step, we add the privacy policy document as a markdown file.

From the **Template files** page of the global template.

1. Create the `organization` folder if it does not already exist.
2. Create a `privacy_policy.md` document in the organization folder
3. Click the `privacy_policy.xml` document to open the **Code editor** panel
4. You can either


  1. Paste the contents of your privacy policy in the editor
  2. OR use the following content

```markdown
Privacy policy
===

Your personal data is collected and used only to improve your experience and
provide necessary services. We do not share your information with third parties
without your consent.
```

1. **Save** the content

> **Tip:** PageSeeder uses markdown for these documents, you can use the **Preview** option in the editor to check how the content is displayed to end-users.

### Configure the organization

In this step, we update the organization config to use our privacy policy so that it is available in the user interface and displayed during the sign-in process

From the **Organization settings** page or the **Template files** page:

1. Open the `organization-config.xml` file in the code editor panel.
2. Add the `<legal>` element inside the `<ui>` element

```diff-xml
     <ui>
+      <legal>
+        <document name="privacy_policy" title="Privacy policy" />
+      </legal>
     </ui>
```

1. To display the privacy policy during the sign up process, add the `agree-on` attribute 

```diff-xml
     <ui>
       <legal>
-        <document name="privacy_policy" title="Privacy policy"/>
+        <document name="privacy_policy" title="Privacy policy" agree-on="signup"/>
       </legal>
     </ui>
```

1. **Save** the organization config 

### Enable changes

In this step, we reload the organization config changes don't take effect immediately.

From the **Organization settings** page

1. Click **Reload** button for the changes to take appear
2. Check that your policy appears correctly under the **Legal documents** section
3. Check that the ‘Privacy policy’ link is also available in your account menu

## Notes

The process is the same for other legal documents such as an acceptable use policy, terms and condition, a cookie policy, or GDPR compliance.