From 87cf1255d06d4d136966e3a8c97837db52616b22 Mon Sep 17 00:00:00 2001 From: Alex Colbeck <36191568+alexcolbeck1@users.noreply.github.com> Date: Wed, 3 Dec 2025 09:53:08 +0000 Subject: [PATCH] Fixing inset text margins, links and formatting --- docs/pages/features/api.md | 4 +- docs/pages/features/features.md | 10 +-- docs/pages/features/letters.md | 2 +- docs/pages/features/mesh.md | 4 +- docs/pages/get-started/onboard-with-notify.md | 45 ++++++------- docs/pages/support/support.md | 4 +- .../using-nhs-notify/(draft)accordion-test.md | 2 +- .../using-nhs-notify/accessible-formats.md | 6 +- .../using-nhs-notify/complete-your-testing.md | 24 +++---- docs/pages/using-nhs-notify/delivery-times.md | 7 ++- .../pages/using-nhs-notify/email-templates.md | 6 +- docs/pages/using-nhs-notify/formatting.md | 63 ++++++++++++------- .../using-nhs-notify/letter-templates.md | 15 +++-- .../letters-in-other-languages.md | 7 ++- docs/pages/using-nhs-notify/links-and-urls.md | 18 +++--- docs/pages/using-nhs-notify/message-status.md | 4 +- .../using-nhs-notify/nhs-app-templates.md | 6 +- .../nhs-digital-first-strategy.md | 4 +- .../pages/using-nhs-notify/personalisation.md | 13 ++-- .../recipients-you-cannot-message.md | 4 +- ...l-recipients-who-your-messages-are-from.md | 20 +++--- .../tell-us-who-you-want-to-message.md | 10 +-- .../text-message-templates.md | 3 +- .../pages/using-nhs-notify/upload-a-letter.md | 31 ++++----- 24 files changed, 180 insertions(+), 132 deletions(-) diff --git a/docs/pages/features/api.md b/docs/pages/features/api.md index 379912a..1366a21 100644 --- a/docs/pages/features/api.md +++ b/docs/pages/features/api.md @@ -12,6 +12,6 @@ section: Accessing NHS Notify NHS England organisations and services can integrate the NHS Notify API with their web applications or back office systems. -[Read our API documentation (opens in a new tab)](https://digital.nhs.uk/developer/api-catalogue/nhs-notify){:target="\_blank"}. +Read our API documentation (opens in a new tab). -If you’re a developer you can also try our [sandbox test environment (opens in a new tab)](https://digital.nhs.uk/developer/api-catalogue/nhs-notify#overview--environments-and-testing){:target="\_blank"}. +If you're a developer you can also try our sandbox test environment (opens in a new tab). diff --git a/docs/pages/features/features.md b/docs/pages/features/features.md index 06c9fd0..8402944 100644 --- a/docs/pages/features/features.md +++ b/docs/pages/features/features.md @@ -31,9 +31,9 @@ You can send messages in bulk or individually. ## Send messages to groups of recipients without their contact details -You only need a person’s NHS number to send them messages. Learn how to [tell us who you want to message]({% link pages/using-nhs-notify/tell-us-who-you-want-to-message.md %}). +You only need a person's NHS number to send them messages. Learn how to [tell us who you want to message]({% link pages/using-nhs-notify/tell-us-who-you-want-to-message.md %}). -Create specific cohorts of recipients by using [Cohorting as a Service (opens in a new tab)](https://digital.nhs.uk/services/cohorting-as-a-service-caas){:target="\_blank"}. +Create specific cohorts of recipients by using Cohorting as a Service (opens in a new tab). ## Write your messages @@ -62,7 +62,7 @@ You can set up routing plans to: ## Prevent sending people unnecessary messages -NHS Notify uses the [Personal Demographics Service](https://digital.nhs.uk/services/personal-demographics-service) to automatically prevent you from messaging [recipients you cannot message]({% link pages/using-nhs-notify/recipients-you-cannot-message.md %}). +NHS Notify uses the Personal Demographics Service (opens in a new tab) to automatically prevent you from messaging [recipients you cannot message]({% link pages/using-nhs-notify/recipients-you-cannot-message.md %}). ## Reach people with additional needs @@ -77,9 +77,9 @@ Track how many messages you’ve sent and find out which ones are not being deli ## Automatic sending -To send messages automatically, you’ll need a developer to integrate with the NHS Notify API. +To send messages automatically, you'll need a developer to integrate with the NHS Notify API. -[Read our API documentation (opens in a new tab)](https://digital.nhs.uk/developer/api-catalogue/nhs-notify){:target="\_blank"}. +Read our API documentation (opens in a new tab). ## Keep your data secure diff --git a/docs/pages/features/letters.md b/docs/pages/features/letters.md index 9193e3b..6afdd5e 100644 --- a/docs/pages/features/letters.md +++ b/docs/pages/features/letters.md @@ -53,7 +53,7 @@ NHS Notify uses C5 size envelopes with an address window. This means the A4 lett ### NHS barcode -Letters about test results, appointments and urgent messages can get [Royal Mail's NHS barcode (opens in a new tab)](https://www.royalmailwholesale.com/news/nhs-mail-new-barcode-solution){:target="\_blank"} on the envelope. +Letters about test results, appointments and urgent messages can get Royal Mail's NHS barcode (opens in a new tab) on the envelope. You'll need to send by 1st or 2nd class to be able to get the NHS barcode. If you choose NHS Notify's standard postage, you will not get the barcode but your postage rate will be much cheaper. Find out more about [pricing]({% link pages/pricing/letters.md %}). diff --git a/docs/pages/features/mesh.md b/docs/pages/features/mesh.md index 020e057..b18b6cc 100644 --- a/docs/pages/features/mesh.md +++ b/docs/pages/features/mesh.md @@ -10,7 +10,7 @@ permalink: /features/mesh section: Accessing NHS Notify --- -NHS England organisations and services can use the [Message Exchange for Social Care and Health (MESH)](https://digital.nhs.uk/services/message-exchange-for-social-care-and-health-mesh){:target="\_blank"} to send messages with NHS Notify. +NHS England organisations and services can use the Message Exchange for Social Care and Health (MESH) (opens in a new tab) to send messages with NHS Notify. You should only use MESH to send messages if your organisation or service: @@ -18,6 +18,6 @@ You should only use MESH to send messages if your organisation or service: - only needs to send batches of messages to specific groups of recipients - does not need advanced features offered by NHS Notify API -[Read our MESH documentation (opens in a new tab)](https://digital.nhs.uk/developer/api-catalogue/nhs-notify-mesh){:target="\_blank"}. +Read our MESH documentation (opens in a new tab). Check if MESH is right for you by contacting our engagement team at . diff --git a/docs/pages/get-started/onboard-with-notify.md b/docs/pages/get-started/onboard-with-notify.md index 42ea0e5..153a61f 100644 --- a/docs/pages/get-started/onboard-with-notify.md +++ b/docs/pages/get-started/onboard-with-notify.md @@ -44,31 +44,31 @@ You'll need to: {% include components/details.html heading='Set up your APIM application ID' -text='To set up an APIM application ID, you need to: +text="To set up an APIM application ID, you need to: -1. [Sign in to your NHS Digital developer account](https://digital.nhs.uk/developer). +1. Sign in to your NHS Digital developer account (opens in a new tab). 2. Create an APIM application. -3. Select ‘integration test’ as the environment. -4. Select ‘Communications Manager (integration environment)’ as the connected API. - ' +3. Select 'integration test' as the environment. +4. Select 'Communications Manager (integration environment)' as the connected API. + " %} {% include components/details.html heading='Choose how you want to see your message performance' -text='To see how your messages perform, you can [get the status of a message](https://digital.nhs.uk/developer/api-catalogue/nhs-notify#get-/v1/messages/-messageId-) or choose to receive [realtime message callbacks](https://digital.nhs.uk/developer/api-catalogue/nhs-notify#post-/%3Cclient-provided-message-status-URI%3E). +text="To see how your messages perform, you can get the status of a message (opens in a new tab) or choose to receive realtime message callbacks (opens in a new tab). -If you want to receive realtime message status callbacks, you‘ll need to: +If you want to receive realtime message status callbacks, you'll need to: -- decide which [message, channel or supplier statuses](https://notify.nhs.uk/using-nhs-notify/message-channel-supplier-status) you want to receive +- decide which [message, channel or supplier statuses](/using-nhs-notify/message-channel-supplier-status) you want to receive - prepare an endpoint URL for your integration - ' + " %} ### If you're using NHS Notify MESH You'll need to: -1. [Set up your MESH mailboxes (opens in a new tab)](https://digital.nhs.uk/developer/api-catalogue/nhs-notify-mesh/set-up-nhs-notify-mesh#set-up-your-mesh-mailboxes) and make a note of their IDs. +1. Set up your MESH mailboxes (opens in a new tab) and make a note of their IDs. 2. Decide which reports you want when you get reports on how your messages perform. ## 3. Confirm your setup to get access to our integration environment @@ -77,7 +77,8 @@ You must confirm how you'll be set up with NHS Notify using our online form so w {% include components/inset-text.html text='Only complete the online form and confirm your setup if you’ve been invited to onboard.' - %} + classes='nhsuk-u-margin-top-2' +%} {% include components/action-link.html url='https://forms.office.com/Pages/ResponsePage.aspx?id=slTDN7CF9UeyIge0jXdO4-wXWyN79ZdLkmec1Fsc491UNFRYSDFTOUs5TzZQUjlOVUlGWTQxQTlMQy4u' @@ -92,9 +93,9 @@ In the form you'll be asked to: heading='Confirm your use case' text='You can only use NHS Notify if your organisation or service sends messages that are: -- [part of a campaign](https://notify.nhs.uk/using-nhs-notify/campaigns) -- [triggered when something happens in your service](https://notify.nhs.uk/using-nhs-notify/event-based-messaging) -- [sent directly on a one-to-one basis](https://notify.nhs.uk/using-nhs-notify/direct-messaging) +- [part of a campaign](/using-nhs-notify/campaigns) +- [triggered when something happens in your service](/using-nhs-notify/event-based-messaging) +- [sent directly on a one-to-one basis](/using-nhs-notify/direct-messaging) ' %} @@ -104,10 +105,10 @@ text='When you send messages you’ll need to tell your recipients who your mess Before you provide your message sender names, you should understand more about: -- [NHS App sender names](https://notify.nhs.uk/using-nhs-notify/tell-recipients-who-your-messages-are-from#nhs-app-sender-name) -- [email sender names and from addresses](https://notify.nhs.uk/using-nhs-notify/tell-recipients-who-your-messages-are-from#email-sender-name-and-from-email-address) -- [email reply-to email addresses](https://notify.nhs.uk/using-nhs-notify/tell-recipients-who-your-messages-are-from#reply-to-email-address) -- [text message sender names](https://notify.nhs.uk/using-nhs-notify/tell-recipients-who-your-messages-are-from#text-message-sender-name) +- [NHS App sender names](/using-nhs-notify/tell-recipients-who-your-messages-are-from#nhs-app-sender-name) +- [email sender names and from addresses](/using-nhs-notify/tell-recipients-who-your-messages-are-from#email-sender-name-and-from-email-address) +- [email reply-to email addresses](/using-nhs-notify/tell-recipients-who-your-messages-are-from#reply-to-email-address) +- [text message sender names](/using-nhs-notify/tell-recipients-who-your-messages-are-from#text-message-sender-name) ' %} @@ -132,7 +133,7 @@ The form will also ask for the routing plans that you want to use for your messa heading='Tell us who will create and submit templates' text='You do not need to do this if you send direct messages and use free-text inputs. -When you get access to NHS Notify’s integration environment, you’ll need to [create and submit your templates](https://notify.nhs.uk/using-nhs-notify/create-and-submit-a-template). These templates will be used as the messages you send when you go live. +When you get access to NHS Notify’s integration environment, you’ll need to [create and submit your templates](/using-nhs-notify/create-and-submit-a-template). These templates will be used as the messages you send when you go live. To access this feature, you must nominate someone in your organisation or service to sign in with NHS Notify. This is because creating and submitting templates is only available to one person in an organisation or service at this time. @@ -160,7 +161,7 @@ They'll contact you to either: ## 4. Build your integration -Once you get access to our integration environment, you can start building your integration with [NHS Notify API](https://digital.nhs.uk/developer/api-catalogue/nhs-notify) or [NHS Notify MESH](https://digital.nhs.uk/developer/api-catalogue/nhs-notify-mesh). +Once you get access to our integration environment, you can start building your integration with NHS Notify API (opens in a new tab) or NHS Notify MESH (opens in a new tab). How you build your integration to meet your needs is your responsibility. @@ -181,7 +182,7 @@ When you’re ready to go live, contact your onboarding manager. They'll ask you to: - send them your SCAL -- sign our [connection agreement](https://digital.nhs.uk/developer/guides-and-documentation/online-connection-agreement) if you’re a non-NHSE organisation +- sign our connection agreement (opens in a new tab) if you're a non-NHSE organisation ### If you're using NHS Notify API @@ -213,7 +214,7 @@ We will: ## 7. Go live -On your go live date, you can start making requests via [NHS Notify API](https://digital.nhs.uk/developer/api-catalogue/nhs-notify) or [NHS Notify MESH](https://digital.nhs.uk/developer/api-catalogue/nhs-notify-mesh) to send messages with NHS Notify. +On your go live date, you can start making requests via NHS Notify API (opens in a new tab) or NHS Notify MESH (opens in a new tab) to send messages with NHS Notify. ### After you go live diff --git a/docs/pages/support/support.md b/docs/pages/support/support.md index b4b9781..929144c 100644 --- a/docs/pages/support/support.md +++ b/docs/pages/support/support.md @@ -9,9 +9,9 @@ has_children: true permalink: /support/ --- -NHS Notify is a [silver service](https://digital.nhs.uk/services/reference-guide#service-levels){:target="\_blank"} and is available 24 hours a day, 365 days a year. +NHS Notify is a silver service (opens in a new tab) and is available 24 hours a day, 365 days a year. -If you're live with NHS Notify and need help, [submit a case with Service Now](https://nhsdigitallive.service-now.com/csm){:target="\_blank"}. +If you're live with NHS Notify and need help, submit a case with Service Now (opens in a new tab). If you have any general questions about NHS Notify, send an email to . diff --git a/docs/pages/using-nhs-notify/(draft)accordion-test.md b/docs/pages/using-nhs-notify/(draft)accordion-test.md index 5410e7d..4f6ce1e 100644 --- a/docs/pages/using-nhs-notify/(draft)accordion-test.md +++ b/docs/pages/using-nhs-notify/(draft)accordion-test.md @@ -106,5 +106,5 @@ You cannot send transactional messages to recipients with: - invalid email addresses - an informal or formal death status -[Find out more about recipients you cannot message](https://notify.nhs.uk/using-nhs-notify/recipients-you-cannot-message)." +[Find out more about recipients you cannot message](/using-nhs-notify/recipients-you-cannot-message)." %} diff --git a/docs/pages/using-nhs-notify/accessible-formats.md b/docs/pages/using-nhs-notify/accessible-formats.md index a796c37..f693544 100644 --- a/docs/pages/using-nhs-notify/accessible-formats.md +++ b/docs/pages/using-nhs-notify/accessible-formats.md @@ -12,7 +12,7 @@ section: Writing a message Before you start to send messages, consider the access needs of your recipients. -All organisations that provide NHS care or publicly-funded adult social care are legally required to follow the [NHS England's Accessible Information Standard](https://www.england.nhs.uk/about/equality/equality-hub/patient-equalities-programme/equality-frameworks-and-information-standards/accessibleinfo/). +All organisations that provide NHS care or publicly-funded adult social care are legally required to follow the NHS England's Accessible Information Standard (opens in a new tab). ## Accessible letter formats @@ -47,7 +47,7 @@ This is available for all message channels. Do this by: - speaking to our engagement team when you first [get started]({% link pages/get-started/get-started.md %}) with NHS Notify -- raising a [Service Now request](https://nhsdigitallive.service-now.com/csm) if you're already using NHS Notify and have existing templates +- raising a Service Now request (opens in a new tab) if you're already using NHS Notify and have existing templates ### 2. Create your templates and routing plans @@ -61,7 +61,7 @@ Provide recipients' NHS numbers as separate data files for each type of accessib ### 4. We'll check for recipients with access needs -NHS Notify checks for recipients who need letters in accessible formats using the [Personal Demographics Service (PDS)](https://digital.nhs.uk/services/personal-demographics-service). +NHS Notify checks for recipients who need letters in accessible formats using the Personal Demographics Service (PDS) (opens in a new tab). It’s your responsibility to message recipients based on their access needs. diff --git a/docs/pages/using-nhs-notify/complete-your-testing.md b/docs/pages/using-nhs-notify/complete-your-testing.md index e84c4e1..669e6a7 100644 --- a/docs/pages/using-nhs-notify/complete-your-testing.md +++ b/docs/pages/using-nhs-notify/complete-your-testing.md @@ -9,6 +9,7 @@ nav_order: 2 permalink: /using-nhs-notify/complete-your-testing section: Going live --- + You'll need to carry out testing to make sure you're ready to start sending messages to recipients with NHS Notify. You're responsible for: @@ -30,8 +31,8 @@ To complete integration testing, you need to give us your final templates and ro You can start testing earlier using: -- our [Sandbox environment](https://digital.nhs.uk/developer/api-catalogue/nhs-notify#overview--environments-and-testing) -- [free-text inputs with NHS Notify API](https://digital.nhs.uk/developer/api-catalogue/nhs-notify#overview--enable-users-to-write-and-send-messages-from-your-software) or [NHS Notify MESH](https://digital.nhs.uk/developer/api-catalogue/nhs-notify-mesh/set-up-nhs-notify-mesh#write-your-messages) - our [routing plan IDs](https://digital.nhs.uk/developer/api-catalogue/nhs-notify#overview--making-your-request-to-send-messages-from-your-software) can be helpful if you've not got your own set up yet +- our Sandbox environment (opens in a new tab) +- free-text inputs with NHS Notify API (opens in a new tab) or NHS Notify MESH (opens in a new tab) - our routing plan IDs (opens in a new tab) can be helpful if you've not got your own set up yet ## Before you start @@ -40,7 +41,7 @@ Make sure your team has someone to: - test (like a test engineer, developer or someone who can send API or MESH requests) - manage your testing and report on progress (like a test manager or delivery manager) -Make sure you've [prepared your integration](https://notify.nhs.uk/get-started/onboard-with-nhs-notify#2-prepare-your-integration). +Make sure you've [prepared your integration](/get-started/onboard-with-nhs-notify#2-prepare-your-integration). ## How to carry out integration testing @@ -49,7 +50,7 @@ Make sure you've [prepared your integration](https://notify.nhs.uk/get-started/o To prepare for testing, you need to: - arrange your own Personal Demographics Service (PDS) data - contact your onboarding manager if you have any questions -- provide us with your [test personalisation data](https://notify.nhs.uk/using-nhs-notify/personalisation#providing-example-data) (if you're using templates rather than free-text inputs) +- provide us with your [test personalisation data](/using-nhs-notify/personalisation#providing-example-data) (if you're using templates rather than free-text inputs) - ask your onboarding manager to set up your NHS App test data (if you're using the NHS App) ### 2. Confirm your connection to the integration environment @@ -59,9 +60,10 @@ You need to show you've connected to our INT environment by sending an API reque You'll know your connection is working when you can successfully run tests in the INT environment. {% include components/inset-text.html - text='If you’re using free-text inputs and NHS Notify’s dedicated routing plans, you do not need to do any more steps for integration testing. +text='If you’re using free-text inputs and NHS Notify’s dedicated routing plans, you do not need to do any more steps for integration testing. Next, carry out [NHS App testing](#nhs-app-integration-testing) (if you’re sending NHS App messages) and [production smoke testing](#production-smoke-testing).' +classes='nhsuk-u-margin-top-2' %} ### 3. Approve proofs of your messages @@ -82,15 +84,15 @@ It's up to you to decide how to do this. We recommend making sure that: - the correct templates are used in the correct routing plans, for example, one plan might be for invitations and one might be for reminders {% include components/details.html - heading='If you need help getting test evidence' - text='Let your onboarding manager know 2 weeks in advance if you need support to carry out this step. +heading='If you need help getting test evidence' +text='Let your onboarding manager know 2 weeks in advance if you need support to carry out this step. We can get evidence of your test outputs for emails and text messages if you give us your test data and request IDs. Find out about [NHS App message test outputs](#nhs-app-integration-testing).' %} {% include components/details.html - heading='If you need support' - text='Contact your onboarding manager if you need support or have any problems with your testing. Tell us the following details: +heading='If you need support' +text='Contact your onboarding manager if you need support or have any problems with your testing. Tell us the following details: - a description of the request and what you expected to happen - the date and time of the request @@ -98,7 +100,7 @@ We can get evidence of your test outputs for emails and text messages if you giv - the request ID that the API batch-message endpoint returned, if you used NHS Notify API - the request item ID that the API message endpoint returned, if you used NHS Notify API - the request ID that MESH returned, if you used NHS Notify MESH' -%} + %} ## NHS App integration testing @@ -113,7 +115,7 @@ Give your onboarding manager the following details of the people on your team wh - their email addresses - these can be personal details if they're testing on personal devices - whether they have Android or Apple devices -We'll then send you a link to download the app from the [Apple Store](https://www.apple.com/uk/store) or [Google Play](https://play.google.com/store/apps?hl=en). +We'll then send you a link to download the app from the Apple Store (opens in a new tab) or Google Play (opens in a new tab). ### 2. Sign in with test accounts diff --git a/docs/pages/using-nhs-notify/delivery-times.md b/docs/pages/using-nhs-notify/delivery-times.md index 45c5aeb..17ff9e2 100644 --- a/docs/pages/using-nhs-notify/delivery-times.md +++ b/docs/pages/using-nhs-notify/delivery-times.md @@ -60,13 +60,14 @@ We use NHS Notify's standard postage as our default for letters. Most letters ge If you need different postage, such as 1st or 2nd class, speak to your onboarding manager. {% include components/inset-text.html -text='From 28 July, delivery times for all letters except 1st class are changing. This is due to Royal Mail’s service reforms. +text="From 28 July, delivery times for all letters except 1st class are changing. This is due to Royal Mail's service reforms. -For more information, visit [Royal Mail’s website](https://www.royalmail.com/receiving/the-future-of-letter-deliveries).' +For more information, visit Royal Mail's website (opens in a new tab)." +classes="nhsuk-u-margin-top-2" %} [Learn more about letters]({% link pages/features/letters.md %}). ### NHS barcode -If you want to send your letter with [Royal Mail's NHS barcode](https://notify.nhs.uk/features/letters#nhs-barcode), your message content needs to meet certain criteria and you need to use 1st or 2nd class postage. Speak to your onboarding manager to discuss your options. +If you want to send your letter with [Royal Mail's NHS barcode](/features/letters#nhs-barcode), your message content needs to meet certain criteria and you need to use 1st or 2nd class postage. Speak to your onboarding manager to discuss your options. diff --git a/docs/pages/using-nhs-notify/email-templates.md b/docs/pages/using-nhs-notify/email-templates.md index 5dc35da..34dff74 100644 --- a/docs/pages/using-nhs-notify/email-templates.md +++ b/docs/pages/using-nhs-notify/email-templates.md @@ -72,7 +72,8 @@ Use the style ‘Hyperlink' in the template for links. For emails, you can convert text into a link instead of writing the full web address. For example: {% include components/inset-text.html - text='[content guide on the NHS service manual](https://service-manual.nhs.uk/content)' + text='[content guide on the NHS service manual](https://service-manual.nhs.uk/content)' + classes='nhsuk-u-margin-top-2' %} Link text should tell the recipient what action they need to take and where the link goes. @@ -82,7 +83,8 @@ Never use ‘click here’, ‘click link’, ‘this link’ or ‘more’, as If the recipient is not expecting to receive an email from you, we recommend using the full URL instead of link text. Start with https://. For example: {% include components/inset-text.html - text='https://www.service-manual.nhs.uk/content' + text='https://www.service-manual.nhs.uk/content' + classes='nhsuk-u-margin-top-2' %} ### Short URLs diff --git a/docs/pages/using-nhs-notify/formatting.md b/docs/pages/using-nhs-notify/formatting.md index d2351c9..76c52e9 100644 --- a/docs/pages/using-nhs-notify/formatting.md +++ b/docs/pages/using-nhs-notify/formatting.md @@ -14,7 +14,7 @@ NHS Notify uses Markdown to format message content. You can see formatting instructions while you’re editing NHS App message, email and text message templates. -To add formatting to a letter, download our blank template, apply the styles then [upload your letter as a PDF](https://notify.nhs.uk/using-nhs-notify/upload-a-letter). +To add formatting to a letter, download our blank template, apply the styles then [upload your letter as a PDF](/using-nhs-notify/upload-a-letter). ## Formatting options @@ -40,13 +40,13 @@ Text message templates can include [links and URLs]({% link pages/using-nhs-noti Letter templates can include: -- [bullet points](https://notify.nhs.uk/using-nhs-notify/upload-a-letter#bullet-points) -- [headings](https://notify.nhs.uk/using-nhs-notify/upload-a-letter#headings) -- [numbered lists](https://notify.nhs.uk/using-nhs-notify/upload-a-letter#numbered-lists) -- [page breaks](https://notify.nhs.uk/using-nhs-notify/upload-a-letter#page-breaks) -- [paragraphs](https://notify.nhs.uk/using-nhs-notify/upload-a-letter#paragraphs-and-body-text) +- [bullet points](/using-nhs-notify/upload-a-letter#bullet-points) +- [headings](/using-nhs-notify/upload-a-letter#headings) +- [numbered lists](/using-nhs-notify/upload-a-letter#numbered-lists) +- [page breaks](/using-nhs-notify/upload-a-letter#page-breaks) +- [paragraphs](/using-nhs-notify/upload-a-letter#paragraphs-and-body-text) - [links and URLs]({% link pages/using-nhs-notify/links-and-urls.md %}) -- [images](https://notify.nhs.uk/using-nhs-notify/upload-a-letter#images) +- [images](/using-nhs-notify/upload-a-letter#images) You can also find out about: @@ -67,12 +67,17 @@ Leave an empty line before the first bullet point and after the last bullet poin Copy this example to add bullet points to NHS App messages and emails: {% include components/inset-text.html - text='Introduce bullet points with a lead-in line ending with a colon:

* bullet point 1
* bullet point 2
 ' - %} +text='`Introduce bullet points with a lead-in line ending with a colon:` + +`* bullet point 1`
+`* bullet point 2`
+ ' +classes='nhsuk-u-margin-top-2' +%} You cannot use bullet points in text message templates. -Find out how to use [bullet points in letter templates](https://notify.nhs.uk/using-nhs-notify/upload-a-letter#bullet-points). +Find out how to use [bullet points in letter templates](/using-nhs-notify/upload-a-letter#bullet-points). ### Headings @@ -83,18 +88,20 @@ Use subheadings to break up the rest of your content. Your first subheading must Use one hash symbol followed by a space for a heading in NHS App messages and emails. For example: {% include components/inset-text.html - text='# This is a heading' + text='`# This is a heading`' + classes='nhsuk-u-margin-top-2' %} Use 2 hash symbols followed by a space for a subheading in NHS App messages and emails. For example: {% include components/inset-text.html - text='## This is a subheading' + text='`## This is a subheading`' + classes='nhsuk-u-margin-top-2' %} You cannot use headings in text message templates. -Find out how to use [headings in letter templates](https://notify.nhs.uk/using-nhs-notify/upload-a-letter#headings). +Find out how to use [headings in letter templates](/using-nhs-notify/upload-a-letter#headings). ### Horizontal lines @@ -103,7 +110,12 @@ Use a horizontal line to create separate sections in emails. To add a horizontal line between 2 paragraphs, use 3 dashes. Leave one empty line space after the first paragraph. For example: {% include components/inset-text.html -text='First paragraph

---

Second paragraph' +text='`First paragraph` + +`---` + +`Second paragraph`' +classes='nhsuk-u-margin-top-2' %} You cannot use horizontal lines in NHS App message, text message and letter templates. @@ -117,12 +129,18 @@ You do not need a lead-in line for a numbered list. Copy this example to add numbered steps to NHS App messages and emails: {% include components/inset-text.html -text='
1. Leave one empty line space before starting your list.
2. Enter a number followed by a full stop and a space to add an item.
3. Start each item with a capital letter and end it with a full stop.
4. Leave one empty line space after the last item.' +text=' 
+`1. Leave one empty line space before starting your list.`
+`2. Enter a number followed by a full stop and a space to add an item.`
+`3. Start each item with a capital letter and end it with a full stop.`
+`4. Leave one empty line space after the last item.` +
 ' +classes='nhsuk-u-margin-top-2' %} You cannot use numbered lists in text message templates. -Find out how to use [numbered lists in letter templates](https://notify.nhs.uk/using-nhs-notify/upload-a-letter#numbered-lists). +Find out how to use [numbered lists in letter templates](/using-nhs-notify/upload-a-letter#numbered-lists). ### Line breaks and paragraphs @@ -131,7 +149,8 @@ To add a line break, use 2 spaces at the end of your text. Copy this example to add line breaks to NHS App messages and emails: {% include components/inset-text.html -text='line 1
line 2
line 3 ' + text='`line 1`  
`line 2`  
`line 3`' + classes='nhsuk-u-margin-top-2' %} To add a paragraph, use a blank line between each paragraph. @@ -139,12 +158,13 @@ To add a paragraph, use a blank line between each paragraph. Copy this example to add paragraphs to NHS App messages and emails: {% include components/inset-text.html -text='line 1

line 2

line 3' + text='`line 1`

`line 2`

`line 3`' + classes='nhsuk-u-margin-top-2' %} You cannot use line breaks and paragraphs in text message templates. -Find out how to use [paragraphs in letter templates](https://notify.nhs.uk/using-nhs-notify/upload-a-letter#paragraphs-and-body-text). +Find out how to use [paragraphs in letter templates](/using-nhs-notify/upload-a-letter#paragraphs-and-body-text). ### Bold text @@ -153,7 +173,8 @@ Use 2 asterisk symbols on either side of the words you want to be bold. Copy this example to add bold text to NHS App messages: {% include components/inset-text.html -text='**this is bold text**' + text='`**this is bold text**`' + classes='nhsuk-u-margin-top-2' %} You cannot use bold text in emails or text message templates. @@ -166,6 +187,6 @@ Attachments and images are not currently available for NHS App messages, emails If you need to send an attachment or image, host it separately on a website and add a link to it in your message content. -Find out about [images in letters](https://notify.nhs.uk/using-nhs-notify/upload-a-letter#images). +Find out about [images in letters](/using-nhs-notify/upload-a-letter#images). If you need to include attachments such as leaflets with your letters, email us at . diff --git a/docs/pages/using-nhs-notify/letter-templates.md b/docs/pages/using-nhs-notify/letter-templates.md index d7e79c3..a471926 100644 --- a/docs/pages/using-nhs-notify/letter-templates.md +++ b/docs/pages/using-nhs-notify/letter-templates.md @@ -49,7 +49,8 @@ If you're copying and pasting text from another document, paste it without any f You can also use [Microsoft Word's format painter](https://support.microsoft.com/en-gb/office/use-the-format-painter-4bb415a9-d4e4-42b7-b579-170adc594e40) to copy the formatting of the styles and apply it to your text. {% include components/inset-text.html - text="Keep the comments and pre-formatted text in the template until you've finished adding your message content. They'll help you to apply the styles." + text="Keep the comments and pre-formatted text in the template until you've finished adding your message content. They'll help you to apply the styles." + classes='nhsuk-u-margin-top-2' %} Find out how to use: @@ -139,7 +140,8 @@ Use the style 'Hyperlink' in the template for links. Write links in full, starting with https://. For example: {% include components/inset-text.html - text='https://www.service-manual.nhs.uk/content' + text='https://www.service-manual.nhs.uk/content' + classes='nhsuk-u-margin-top-2' %} Links in letters are in bold to make them stand out. Do not use underlined text or italics. @@ -180,7 +182,8 @@ You'll need to generate the QR code yourself. You must also provide a short URL or written instructions for how to find your webpage. For example: {% include components/inset-text.html - text='scan the QR code or visit https://www.notify.nhs.uk' + text='scan the QR code or visit https://www.notify.nhs.uk' + classes='nhsuk-u-margin-top-2' %} ## Content you should not edit @@ -216,7 +219,8 @@ It appears above the body content of the letter and is right aligned. The page count shows the current page number and the total number of pages. For example: {% include components/inset-text.html - text='Page 1 of 2' + text='Page 1 of 2' + classes='nhsuk-u-margin-top-2' %} It updates automatically. @@ -245,5 +249,6 @@ Name your PDF template clearly so that it's easy to identify. Make sure you incl For example: {% include components/inset-text.html - text='vaccinations_under-16_english_standard_letter_v1' + text='vaccinations_under-16_english_standard_letter_v1' + classes='nhsuk-u-margin-top-2' %} diff --git a/docs/pages/using-nhs-notify/letters-in-other-languages.md b/docs/pages/using-nhs-notify/letters-in-other-languages.md index e46c3ea..b73ab71 100644 --- a/docs/pages/using-nhs-notify/letters-in-other-languages.md +++ b/docs/pages/using-nhs-notify/letters-in-other-languages.md @@ -14,7 +14,7 @@ NHS Notify allows you to message patients and members of the public using other ## Language (A to Z) -NHS Notify can support any languages and character sets that are listed in the [Personal Demographics Service (PDS)](https://digital.nhs.uk/services/personal-demographics-service). +NHS Notify can support any languages and character sets that are listed in the Personal Demographics Service (PDS) (opens in a new tab). {% include components/details.html heading='Languages and character sets we support' @@ -51,7 +51,8 @@ text=' %} {% include components/inset-text.html - text="You can request additional languages, as long as they’re in PDS. We’ll need to test these languages so make sure you leave enough time for this." + text="You can request additional languages, as long as they're in PDS. We'll need to test these languages so make sure you leave enough time for this." + classes="nhsuk-u-margin-top-2" %} ## How to send letters in other languages @@ -73,7 +74,7 @@ Aim to keep your message content to 2 double-sided sheets to save costs. This wi ### We'll check for recipients who need letters in other languages -NHS Notify checks for recipients who need letters in other languages using the [Personal Demographics Service (PDS)](https://digital.nhs.uk/services/personal-demographics-service). +NHS Notify checks for recipients who need letters in other languages using the Personal Demographics Service (PDS) (opens in a new tab). You need to decide whether to message recipients based on their access or language needs. diff --git a/docs/pages/using-nhs-notify/links-and-urls.md b/docs/pages/using-nhs-notify/links-and-urls.md index a732824..5858181 100644 --- a/docs/pages/using-nhs-notify/links-and-urls.md +++ b/docs/pages/using-nhs-notify/links-and-urls.md @@ -19,7 +19,8 @@ You can see instructions on links and URLs while you’re editing a template. To add a link to a message, you can write the URL in full. For example: {% include components/inset-text.html - text='Book now at https://www.nhs.uk/example' + text='Book now at https://www.nhs.uk/example' + classes='nhsuk-u-margin-top-2' %} For NHS App messages and emails, use square brackets around the full URL to make it the link text and use round brackets around the full URL. @@ -27,20 +28,22 @@ For NHS App messages and emails, use square brackets around the full URL to make Make sure there are no spaces between the brackets or the link will not work. For example: {% include components/inset-text.html - text='[https://www.nhs.uk/example](https://www.nhs.uk/example)' + text='`[https://www.nhs.uk/example](https://www.nhs.uk/example)`' + classes='nhsuk-u-margin-top-2' %} For letters, you do not need to include https:// at the start. For example: {% include components/inset-text.html - text='Book now at www.nhs.uk/example' + text='Book now at www.nhs.uk/example' + classes='nhsuk-u-margin-top-2' %} URLs should be easy to read. {% include components/details.html - heading='Short URLs' - text=' +heading='Short URLs' +text=' If you have a long, complex web address, you can request a short URL from GOV.UK. This can take some time and may delay your template creation. We do not recommend using a third-party link shortening service because: @@ -48,7 +51,7 @@ We do not recommend using a third-party link shortening service because: - your users cannot see where the link will take them - your link might stop working if there’s a service outage - you can no longer control where the redirect goes' -%} + %} ## Converting text into a link @@ -57,7 +60,8 @@ For NHS App messages and emails, you can convert text into a link. Use square brackets around the link text and round brackets around the full URL. Make sure there are no spaces between the brackets or the link will not work. For example: {% include components/inset-text.html - text='[Read more](https://www.nhs.uk/example)' + text='`[Read more](https://www.nhs.uk/example)`' + classes='nhsuk-u-margin-top-2' %} Link text should tell the recipient what action they need to take and where the link goes. diff --git a/docs/pages/using-nhs-notify/message-status.md b/docs/pages/using-nhs-notify/message-status.md index c633cbe..824a6ab 100644 --- a/docs/pages/using-nhs-notify/message-status.md +++ b/docs/pages/using-nhs-notify/message-status.md @@ -16,9 +16,9 @@ This page describes the statuses you'll see when using NHS Notify API or NHS Not heading='If you’re using NHS Notify API' text=' -Check the status of a single message or channel by using the [get message status endpoint](https://digital.nhs.uk/developer/api-catalogue/nhs-notify#get-/v1/messages/-messageId-). +Check the status of a single message or channel by using the get message status endpoint (opens in a new tab). -To check the status of multiple messages automatically, use [message status callbacks](https://digital.nhs.uk/developer/api-catalogue/nhs-notify#post-/%3Cclient-provided-message-status-URI%3E).' +To check the status of multiple messages automatically, use message status callbacks (opens in a new tab).' %} {% include components/details.html diff --git a/docs/pages/using-nhs-notify/nhs-app-templates.md b/docs/pages/using-nhs-notify/nhs-app-templates.md index 0d43f2e..976dd0c 100644 --- a/docs/pages/using-nhs-notify/nhs-app-templates.md +++ b/docs/pages/using-nhs-notify/nhs-app-templates.md @@ -70,7 +70,8 @@ Use the style ‘Hyperlink' in the template for links. For NHS App messages, you can convert text into a link instead of writing the full web address. For example: {% include components/inset-text.html - text='[content guide on the NHS service manual](https://service-manual.nhs.uk/content)' + text='[content guide on the NHS service manual](https://service-manual.nhs.uk/content)' + classes='nhsuk-u-margin-top-2' %} Link text should tell the recipient what action they need to take and where the link goes. @@ -80,7 +81,8 @@ Never use ‘click here’, ‘click link’, ‘this link’ or ‘more’, as If the recipient is not expecting to receive a message from you, we recommend using the full URL instead of link text. Start with https://. For example: {% include components/inset-text.html - text='https://www.service-manual.nhs.uk/content' + text='https://www.service-manual.nhs.uk/content' + classes='nhsuk-u-margin-top-2' %} ### Short URLs diff --git a/docs/pages/using-nhs-notify/nhs-digital-first-strategy.md b/docs/pages/using-nhs-notify/nhs-digital-first-strategy.md index aa8ea78..b1d1759 100644 --- a/docs/pages/using-nhs-notify/nhs-digital-first-strategy.md +++ b/docs/pages/using-nhs-notify/nhs-digital-first-strategy.md @@ -24,6 +24,6 @@ NHS England is working with secondary care trusts and their suppliers to support Over the coming months, we’ll be working closely with trusts to test and roll out solutions that make sure all recipients’ messages can be viewed in the NHS App. We'll also focus on getting the best value for money from other channels like text messages and letters. -If you're a trust or supplier and want to explore how NHS Notify can support your messaging plans, you can visit our [get started](https://notify.nhs.uk/get-started/) page and complete the registration form. +If you're a trust or supplier and want to explore how NHS Notify can support your messaging plans, you can visit our [get started](/get-started/) page and complete the registration form. -For more information, you can read [our blog](https://digital.nhs.uk/blog/transformation-blog/2025/a-digital-first-approach-to-patient-communications){:target="\_blank"} or access the [operational planning guidance](https://www.england.nhs.uk/long-read/2025-26-priorities-and-operational-planning-guidance/){:target="\_blank"}. +For more information, you can read our blog (opens in a new tab) or access the operational planning guidance (opens in a new tab). diff --git a/docs/pages/using-nhs-notify/personalisation.md b/docs/pages/using-nhs-notify/personalisation.md index aef5b79..3335dad 100644 --- a/docs/pages/using-nhs-notify/personalisation.md +++ b/docs/pages/using-nhs-notify/personalisation.md @@ -27,7 +27,7 @@ You can use [Personal Demographics Service (PDS) personalisation fields](#pds-pe ## PDS personalisation fields (automatic data) -NHS Notify uses the Personal Demographics Service (PDS) to populate the personalisation fields in your template. This happens 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) (opens in a new tab) to populate the personalisation fields in your template. This happens 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 fields: @@ -56,10 +56,10 @@ text='Include a personalisation block for each message in your API request. For example, if you wanted to include `((gpSurgery))` and `((appointmentDate))` as custom personalisation fields, the personalisation block for one message would be: -`personalisation: { -"gpSurgery": "The Health Centre, Knaresborough Road", -"appointmentDate": "15 January 2027" -}` +`personalisation: {`
+`"gpSurgery": "The Health Centre, Knaresborough Road",`
+`"appointmentDate": "15 January 2027"`
+`}` Read the API documentation (opens in a new tab) to find out where to put this in your request. ' @@ -73,7 +73,8 @@ The column heading should start with `personalisation_` followed by the same wor For example, if your personalisation fields were `((gpSurgery))` and `((appointmentDate))`, the column headings would be: -`personalisation_gpSurgery` and `personalisation_appointmentDate` +- `personalisation_gpSurgery` +- `personalisation_appointmentDate` The CSV file you use in your MESH request is different to the CSV example data file for custom personalisation fields. diff --git a/docs/pages/using-nhs-notify/recipients-you-cannot-message.md b/docs/pages/using-nhs-notify/recipients-you-cannot-message.md index 9bab6a5..92f695a 100644 --- a/docs/pages/using-nhs-notify/recipients-you-cannot-message.md +++ b/docs/pages/using-nhs-notify/recipients-you-cannot-message.md @@ -12,7 +12,7 @@ section: Sending a message NHS Notify automatically prevents you from sending messages to people who you should not contact. This includes recipients with certain information on their records. -We check the [Personal Demographics Service (PDS)](https://digital.nhs.uk/services/personal-demographics-service) for recipients with: +We check the Personal Demographics Service (PDS) (opens in a new tab) for recipients with: - [flagged records](#flagged-records) - [exit codes](#exit-codes) @@ -28,7 +28,7 @@ Some patients' data is strictly controlled. These records have flags on them in ### Sensitive flag (S flag) -Patients with a sensitive flag (sometimes called an S flag) have [restricted contact details](https://digital.nhs.uk/services/personal-demographics-service/restricting-access-to-a-patients-demographic-record). We do not have access to any information that could reveal their location. +Patients with a sensitive flag (sometimes called an S flag) have restricted contact details (opens in a new tab). We do not have access to any information that could reveal their location. S flags help to protect patients who may be at risk, such as victims of domestic violence, law court witnesses or vulnerable children awaiting adoption. diff --git a/docs/pages/using-nhs-notify/tell-recipients-who-your-messages-are-from.md b/docs/pages/using-nhs-notify/tell-recipients-who-your-messages-are-from.md index d0bd3b1..eeecbc3 100644 --- a/docs/pages/using-nhs-notify/tell-recipients-who-your-messages-are-from.md +++ b/docs/pages/using-nhs-notify/tell-recipients-who-your-messages-are-from.md @@ -35,16 +35,16 @@ Your NHS App sender name is shown when you send recipients messages in the NHS A The NHS App uses your service or organisation’s ODS code to set up your NHS App message sender name. -NHS Notify will ask you for your ODS code during onboarding. [Find your ODS code with the ODS Portal](https://odsportal.digital.nhs.uk/){:target="\_blank"}. +NHS Notify will ask you for your ODS code during onboarding. Find your ODS code with the [ODS Data Search and Export service (opens in a new tab)](https://www.odsdatasearchandexport.nhs.uk/){:target="\_blank"}. -If your organisation or service does not have an ODS code, you can [request a code or update your organisation's details](https://digital.nhs.uk/services/organisation-data-service/request-a-new-code-or-update-organisation-details){:target="\_blank"}. +If your organisation or service does not have an ODS code, you can [request a code or update your organisation's details (opens in a new tab)](https://digital.nhs.uk/services/organisation-data-service/request-a-new-code-or-update-organisation-details){:target="\_blank"}. ### Using other NHS App sender names If you send NHS App messages on behalf of other organisations or services, you can use their sender name instead of yours by: -- [overriding your ODS code in NHS Notify API](https://digital.nhs.uk/developer/api-catalogue/nhs-notify#post-/v1/messages){:target="\_blank"} -- [overriding your ODS code in NHS Notify MESH](https://digital.nhs.uk/developer/api-catalogue/nhs-notify-mesh/sending-a-message#how-to-create-your-request){:target="\_blank"} +- [overriding your ODS code in NHS Notify API (opens in a new tab)](https://digital.nhs.uk/developer/api-catalogue/nhs-notify#post-/v1/messages){:target="\_blank"} +- [overriding your ODS code in NHS Notify MESH (opens in a new tab)](https://digital.nhs.uk/developer/api-catalogue/nhs-notify-mesh/sending-a-message#how-to-create-your-request){:target="\_blank"} To use ODS code overrides, contact the onboarding team. @@ -67,7 +67,8 @@ Use an email sender name that clearly represents your NHS organisation or servic It should help recipients quickly tell who the email is from, for example: {% include components/inset-text.html - text='NHS Vaccination Invitations' + text='NHS Vaccination Invitations' + classes='nhsuk-u-margin-top-2' %} If you send emails for multiple organisations, such as GP surgeries, your email sender name can be more general. It should still be clear who the sender is and that it can be trusted. @@ -82,7 +83,8 @@ Email sender names should not: NHS Notify uses your email sender name to create your from email address. If you include spaces in your email sender name, they will be added as full-stops in your 'from' address, for example: {% include components/inset-text.html - text='your.email.sender.name@notifications.service.gov.uk' + text='your.email.sender.name@notifications.service.gov.uk' + classes='nhsuk-u-margin-top-2' %} Emails will always be sent from the notifications.service.gov.uk domain. @@ -100,7 +102,8 @@ You must choose and provide your reply-to email address during onboarding. Include 'reply-to' in your reply-to email address, for example: {% include components/inset-text.html - text='reply-to-your-service-name@nhs.net' + text='reply-to-your-service-name@nhs.net' + classes='nhsuk-u-margin-top-2' %} ### If you do not want recipients to reply to your emails @@ -108,7 +111,8 @@ Include 'reply-to' in your reply-to email address, for example: Include 'no-reply' in your reply-to email address, for example: {% include components/inset-text.html - text='no-reply-your-service-name@nhs.net' + text='no-reply-your-service-name@nhs.net' + classes='nhsuk-u-margin-top-2' %} ## Text message sender name diff --git a/docs/pages/using-nhs-notify/tell-us-who-you-want-to-message.md b/docs/pages/using-nhs-notify/tell-us-who-you-want-to-message.md index a6fee24..6534587 100644 --- a/docs/pages/using-nhs-notify/tell-us-who-you-want-to-message.md +++ b/docs/pages/using-nhs-notify/tell-us-who-you-want-to-message.md @@ -10,9 +10,9 @@ permalink: /using-nhs-notify/tell-us-who-you-want-to-message section: Sending a message --- -You only need a patient's [NHS number](https://digital.nhs.uk/services/personal-demographics-service/nhs-number) to send them messages. +You only need a patient's NHS number (opens in a new tab) to send them messages. -NHS Notify finds people's contact details using their NHS numbers in the [Personal Demographics Service (PDS)](https://digital.nhs.uk/services/personal-demographics-service). +NHS Notify finds people's contact details using their NHS numbers in the Personal Demographics Service (PDS) (opens in a new tab). ## How to provide recipients' NHS numbers @@ -25,12 +25,12 @@ Use the format shown in the ### If you're using MESH -If you're using the [Message Exchange for Social Care and Health (MESH)](https://digital.nhs.uk/services/message-exchange-for-social-care-and-health-mesh), upload NHS numbers in a CSV file. +If you're using the Message Exchange for Social Care and Health (MESH) (opens in a new tab), upload NHS numbers in a CSV file. The onboarding team will give you an example CSV file on request. -Use the format shown in the -API documentation (opens in a new tab). + ## Providing your own recipient contact details diff --git a/docs/pages/using-nhs-notify/text-message-templates.md b/docs/pages/using-nhs-notify/text-message-templates.md index cf580b8..1127768 100644 --- a/docs/pages/using-nhs-notify/text-message-templates.md +++ b/docs/pages/using-nhs-notify/text-message-templates.md @@ -61,7 +61,8 @@ Use the style ‘Hyperlink' in the template for links. Write links in full, starting with https://. For example: {% include components/inset-text.html - text='https://www.service-manual.nhs.uk/content' + text='https://www.service-manual.nhs.uk/content' + classes='nhsuk-u-margin-top-2' %} ### Short URLs diff --git a/docs/pages/using-nhs-notify/upload-a-letter.md b/docs/pages/using-nhs-notify/upload-a-letter.md index f782c78..f8f22d6 100644 --- a/docs/pages/using-nhs-notify/upload-a-letter.md +++ b/docs/pages/using-nhs-notify/upload-a-letter.md @@ -8,7 +8,6 @@ parent: Using NHS Notify nav_order: 4 permalink: /using-nhs-notify/upload-a-letter section: Writing a message - --- Upload a PDF of your letter and we'll print and post it for you. @@ -47,7 +46,8 @@ If you're copying and pasting text from another document, paste it without any f You can also use [Microsoft Word's format painter](https://support.microsoft.com/en-gb/office/use-the-format-painter-4bb415a9-d4e4-42b7-b579-170adc594e40) to copy the formatting of the styles and apply it to your text. {% include components/inset-text.html - text="Keep the comments and pre-formatted text in the template until you've finished adding your message content. They'll help you to apply the styles." + text="Keep the comments and pre-formatted text in the template until you've finished adding your message content. They'll help you to apply the styles." + classes='nhsuk-u-margin-top-2' %} Find out how to use: @@ -79,27 +79,27 @@ NHS Notify prints letters in the font Noto Sans. You must download and use Noto Sans as the font for all of your letters, including [letters in other languages]({% link pages/using-nhs-notify/letters-in-other-languages.md %}). If you're sending letters in other languages that use different character sets, download Noto Sans in those languages. -Go to [Noto Sans on Google Fonts](https://fonts.google.com/noto/fonts) and choose the languages you need by selecting 'Get font'. Then select 'Download all' to download Noto Sans to your device as a zip file. +Go to Noto Sans on Google Fonts (opens in a new tab) and choose the languages you need by selecting 'Get font'. Then select 'Download all' to download Noto Sans to your device as a zip file. Noto Sans is a free font. {% include components/details.html - heading='Downloading Noto Sans for Windows' - text=' +heading='Downloading Noto Sans for Windows' +text=' 1. Right click the zip file and select ‘Extract all’. 2. Open the file. Open each folder. Select all of the TrueType font files, right click and select ‘Install’. 3. If the folder contains a sub-folder called ‘static’, open this. 4. Select all of the TrueType font files in this folder. Right click and select ‘Install’. - ' -%} + ' + %} {% include components/details.html - heading='Downloading Noto Sans for Mac' - text=' -Follow the [install fonts guidance](https://support.apple.com/en-gb/guide/font-book/fntbk1000/mac). Make sure you install the static fonts. +heading='Downloading Noto Sans for Mac' +text=' +Follow the install fonts guidance (opens in a new tab). Make sure you install the static fonts. -Read [Google’s guidance on installing fonts](https://fonts.google.com/knowledge/using_type/installing_and_managing_fonts) for more information.' +Read Google’s guidance on installing fonts (opens in a new tab) for more information.' %} ## Personalisation @@ -158,7 +158,8 @@ You'll need to generate the QR code yourself. You must also provide a short URL or written instructions for how to find your webpage. For example: {% include components/inset-text.html - text='scan the QR code or visit https://www.notify.nhs.uk' + text='scan the QR code or visit https://www.notify.nhs.uk' + classes='nhsuk-u-margin-top-2' %} ## Content you should not edit @@ -194,7 +195,8 @@ It appears above the body content of the letter and is right aligned. The page count shows the current page number and the total number of pages. For example: {% include components/inset-text.html - text='Page 1 of 2' + text='Page 1 of 2' + classes='nhsuk-u-margin-top-2' %} It updates automatically. @@ -223,5 +225,6 @@ Name your PDF template clearly so that it's easy to identify. Make sure you incl For example: {% include components/inset-text.html - text='vaccinations_under-16_english_standard_letter_v1' + text='vaccinations_under-16_english_standard_letter_v1' + classes='nhsuk-u-margin-top-2' %}