-
-
diff --git a/docs/pages/using-nhs-notify/personalisation.md b/docs/pages/using-nhs-notify/personalisation.md
index b0964c7..06b4665 100644
--- a/docs/pages/using-nhs-notify/personalisation.md
+++ b/docs/pages/using-nhs-notify/personalisation.md
@@ -15,13 +15,16 @@ You can send personalised messages using a single template.
To personalise a message, use double brackets to add a placeholder to your content. For example:
{% include components/inset-text.html
- text='
- {% if page.section != undefined %}
- {{ page.section }}
- {% endif %}
-
+
+ {% if page.section != undefined %}
+ {{ page.section }}
+ {% endif %}
+
{{ page.title }}
+ {{ content }}Hello ((firstName)), your NHS Number is ((nhsNumber))'
+ text='Hello ((firstName)), your NHS Number is ((nhsNumber))'
%}
+## Personal Demographics Service (PDS) personalisation fields
## Personal Demographics Service (PDS) personalisation fields
+NHS Notify uses the [Personal Demographics Service (PDS)](https://digital.nhs.uk/services/personal-demographics-service) to find and populate certain personalisation fields for each recipient. This happens automatically when you [tell us who you want to message]({% link pages/using-nhs-notify/tell-us-who-you-want-to-message.md %}) using recipients' NHS numbers.
NHS Notify uses the [Personal Demographics Service (PDS)](https://digital.nhs.uk/services/personal-demographics-service) to find and populate certain personalisation fields for each recipient. This happens automatically when you [tell us who you want to message]({% link pages/using-nhs-notify/tell-us-who-you-want-to-message.md %}) using recipients' NHS numbers.
+You can use the following PDS personalisation fields in your templates:
You can use the following PDS personalisation fields in your templates:
- fullName
@@ -33,6 +36,7 @@ You can use the following PDS personalisation fields in your templates:
- nhsNumber
- date
+Any placeholders in your content need to match the PDS personalisation fields.
Any placeholders in your content need to match the PDS personalisation fields.
## Providing your own personalisation data
@@ -41,6 +45,7 @@ You can provide your own personalisation data.
Do not send us personalisation data that's already available in PDS. We'll use the PDS data over your own data in this case.
+### If you're using NHS Notify API
### If you're using NHS Notify API
Include a personalisation block in your API request.
@@ -48,23 +53,22 @@ Include a personalisation block in your API request.
For example, if you wanted to include 'practice' as a personalisation field, the personalisation block would be:
{% include components/inset-text.html
-text='{
-
- "practice": "PRACTICE_NAME",
-
-}'
+text='"practice": "PRACTICE_NAME",'
%}
Read the [API documentation](https://digital.nhs.uk/developer/api-catalogue/nhs-notify#post-/v1/message-batches) to find out where to put this in your request.
+### If you're using NHS Notify MESH
### If you're using NHS Notify MESH
Include the personalisation fields as columns in your CSV file.
+The column names should start with 'personalisation\_', followed by the same wording as the placeholders in your template.
The column names should start with 'personalisation\_', followed by the same wording as the placeholders in your template.
For example, if you wanted to include 'practice' as a personalisation field, the column name would be:
{% include components/inset-text.html
text='nhsNumber,requestItemRefId,personalisation_practice'
+ text='nhsNumber,requestItemRefId,personalisation_practice'
%}