From b84f48d86be2e60063b976a65418a43720644a22 Mon Sep 17 00:00:00 2001 From: karlchillmaid Date: Mon, 10 Nov 2025 09:53:43 +0000 Subject: [PATCH 1/8] Remove the old default expiry date information --- source/ruby.html.md.erb | 2 -- 1 file changed, 2 deletions(-) diff --git a/source/ruby.html.md.erb b/source/ruby.html.md.erb index 2a8ac8ac..8ef8f68e 100644 --- a/source/ruby.html.md.erb +++ b/source/ruby.html.md.erb @@ -456,8 +456,6 @@ You can choose any value between 1 week and 78 weeks. When deciding this, you sh If you do not choose a value, the file will be available for the default period of 26 weeks (6 months). -Files sent before 12 April 2023 had a longer default period of 78 weeks (18 months). - ```ruby File.open("file.pdf", "rb") do |f| ... From f425e084b6514c01b6efd4d531b6fbed63148ef8 Mon Sep 17 00:00:00 2001 From: karlchillmaid Date: Mon, 10 Nov 2025 09:54:11 +0000 Subject: [PATCH 2/8] Remove the old default expiry date information --- source/rest-api.html.md.erb | 2 -- 1 file changed, 2 deletions(-) diff --git a/source/rest-api.html.md.erb b/source/rest-api.html.md.erb index 3b0d205e..95b36cf7 100644 --- a/source/rest-api.html.md.erb +++ b/source/rest-api.html.md.erb @@ -501,8 +501,6 @@ You can choose any value between 1 week and 78 weeks. When deciding this, you sh If you do not choose a value, the file will be available for the default period of 26 weeks (6 months). -Files sent before 12 April 2023 had a longer default period of 78 weeks (18 months). - ```javascript "personalisation":{ "first_name": "Amala", From 163691d7521d1b6ea768a45af1ad9e06de5a78ae Mon Sep 17 00:00:00 2001 From: karlchillmaid Date: Mon, 10 Nov 2025 09:54:41 +0000 Subject: [PATCH 3/8] Remove the old default expiry date information --- source/python.html.md.erb | 2 -- 1 file changed, 2 deletions(-) diff --git a/source/python.html.md.erb b/source/python.html.md.erb index 4a8f6371..fc6e4a1e 100644 --- a/source/python.html.md.erb +++ b/source/python.html.md.erb @@ -469,8 +469,6 @@ You can choose any value between 1 week and 78 weeks. When deciding this, you sh If you do not choose a value, the file will be available for the default period of 26 weeks (6 months). -Files sent before 12 April 2023 had a longer default period of 78 weeks (18 months). - ```python from notifications_python_client import prepare_upload From 71217045046402cc7d563e0ac3b33077f74f13d4 Mon Sep 17 00:00:00 2001 From: karlchillmaid Date: Mon, 10 Nov 2025 09:55:22 +0000 Subject: [PATCH 4/8] Remove the old default expiry date information --- source/php.html.md.erb | 2 -- 1 file changed, 2 deletions(-) diff --git a/source/php.html.md.erb b/source/php.html.md.erb index 0f768621..cee0c48b 100644 --- a/source/php.html.md.erb +++ b/source/php.html.md.erb @@ -482,8 +482,6 @@ You can choose any value between 1 week and 78 weeks. When deciding this, you sh If you do not choose a value, the file will be available for the default period of 26 weeks (6 months). -Files sent before 12 April 2023 had a longer default period of 78 weeks (18 months). - ```php try { $file_data = file_get_contents('/path/to/my/file.pdf'); From 5c7cfa49464bdb86ee46bb8cd42e0cb85204b690 Mon Sep 17 00:00:00 2001 From: karlchillmaid Date: Mon, 10 Nov 2025 09:55:59 +0000 Subject: [PATCH 5/8] Remove the old default expiry date information --- source/node.html.md.erb | 2 -- 1 file changed, 2 deletions(-) diff --git a/source/node.html.md.erb b/source/node.html.md.erb index 2f9147f4..ecc8d5d6 100644 --- a/source/node.html.md.erb +++ b/source/node.html.md.erb @@ -531,8 +531,6 @@ You can choose any value between 1 week and 78 weeks. When deciding this, you sh If you do not choose a value, the file will be available for the default period of 26 weeks (6 months). -Files sent before 12 April 2023 had a longer default period of 78 weeks (18 months). - ```javascript let fs = require("fs") From b754f94ddd0e8063bf5035d03f229911f44f0838 Mon Sep 17 00:00:00 2001 From: karlchillmaid Date: Mon, 10 Nov 2025 09:56:28 +0000 Subject: [PATCH 6/8] Remove the old default expiry date information --- source/net.html.md.erb | 2 -- 1 file changed, 2 deletions(-) diff --git a/source/net.html.md.erb b/source/net.html.md.erb index 745cfde0..81e35661 100644 --- a/source/net.html.md.erb +++ b/source/net.html.md.erb @@ -523,8 +523,6 @@ You can choose any value between 1 week and 78 weeks. When deciding this, you sh If you do not choose a value, the file will be available for the default period of 26 weeks (6 months). -Files sent before 12 April 2023 had a longer default period of 78 weeks (18 months). - ```csharp byte[] documentContents = File.ReadAllBytes(""); From 7f18c52906dfcc2a40ba9a4a27594756b8223436 Mon Sep 17 00:00:00 2001 From: karlchillmaid Date: Mon, 10 Nov 2025 09:56:58 +0000 Subject: [PATCH 7/8] Remove the old default expiry date information --- source/java.html.md.erb | 2 -- 1 file changed, 2 deletions(-) diff --git a/source/java.html.md.erb b/source/java.html.md.erb index cb84d5ca..4ee58c94 100644 --- a/source/java.html.md.erb +++ b/source/java.html.md.erb @@ -464,8 +464,6 @@ You can choose any value between 1 week and 78 weeks. When deciding this, you sh If you do not choose a value, the file will be available for the default period of 26 weeks (6 months). -Files sent before 12 April 2023 had a longer default period of 78 weeks (18 months). - ```java ClassLoader classLoader = getClass().getClassLoader(); File file = new File(classLoader.getResource("document_to_upload.pdf").getFile()); From 0ae0a747cf4e637391da963b739480dcf50ba3a0 Mon Sep 17 00:00:00 2001 From: Chris Hill-Scott Date: Tue, 28 Apr 2026 17:53:03 +0100 Subject: [PATCH 8/8] Remove the old default expiry date information from `schema.json` MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit We’re now well past this, all those files should have expired, so we can remove this line as it’s irrelevant. --- openapi/schema.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openapi/schema.json b/openapi/schema.json index 40e11095..badfbee0 100644 --- a/openapi/schema.json +++ b/openapi/schema.json @@ -95,7 +95,7 @@ }, "link_to_file": { "type": "object", - "description": "You can leave out this argument if you do not have any file to attach.\n\nTo send a file by email, add a placeholder to the template then upload a file. The placeholder will contain a secure link to download the file.\n\nThe links are unique and unguessable. GOV.UK Notify cannot access or decrypt your file.\n\nYour file will be available to download for a default period of 26 weeks (6 months).\n\nTo help protect your files you can also:\n\n* ask recipients to confirm their email address before downloading\n* choose the length of time that a file is available to download**Add contact details to the file download page**\n\n1. [Sign in to GOV.UK Notify](https://www.notifications.service.gov.uk/sign-in).\n1. Go to the __Settings__ page.\n1. In the __Email__ section, select __Manage__ on the __Send files by email__ row.\n1. Enter the contact details you want to use, and select __Save__. \n\n**Add a placeholder to the template**\n\n1. [Sign in to GOV.UK Notify](https://www.notifications.service.gov.uk/sign-in).\n1. Go to the __Templates__ page and select the relevant email template.\n1. Select __Edit__.\n1. Add a placeholder to the email template using double brackets. For example: 'Download your file at: ((link_to_file))'\n\nYour email should also tell recipients how long the file will be available to download.\n\n**Upload your file**\n\nYou can upload the following file types:\n\n- PDF (.pdf)\n- CSV (.csv)\n- Text (.odt, .txt, .rtf, .json)\n- MS Word Document (.doc, .docx)\n- Ms Excel Spreadsheet (.xlsx)\n\nYour file must be smaller than 2MB. [Contact the GOV.UK Notify team](https://www.notifications.service.gov.uk/support/ask-question-give-feedback) if you need to send other file types.\n\nYou’ll need to convert the file into a string that is base64 encoded.\n\nPass the encoded string into an object with a `file` key, and put that in the personalisation argument.\n\n**Set the filename**\n\nYou should provide a filename when you upload your file.\n\nThe filename should tell the recipient what the file contains. A memorable filename can help the recipient to find the file again later.\n\nThe filename must end with a file extension. For example, `.csv` for a CSV file. If you include the wrong file extension, recipients may not be able to open your file.\n\nThe filename should be no more that 100 characters long\n\nIf you do not provide a filename for your file, Notify will:\n\n* generate a random filename\n* try to add the correct file extension\n\nIf Notify cannot add the correct file extension, recipients may not be able to open your file.\n\n**Ask recipients to confirm their email address before they can download the file**\n\nWhen a recipient clicks the link in the email you’ve sent them, they have to enter their email address. Only someone who knows the recipient’s email address can download the file.\n\nThis security feature is turned on by default.\n\n**Turn off email address check (not recommended)**\n\nIf you do not want to use this feature, you can turn it off on a file-by-file basis.\n\nYou should not turn this feature off if you send files that contain:\n\n* personally identifiable information\n* commercially sensitive information\n* information classified as ‘OFFICIAL’ or ‘OFFICIAL-SENSITIVE’ under the [Government Security Classifications](https://www.gov.uk/government/publications/government-security-classifications) policy\n\nTo let the recipient download the file without confirming their email address, set the `confirm_email_before_download` flag to `false`.\n\n**Choose the length of time that a file is available to download**\n\nSet the number of weeks you want the file to be available using the `retention_period` key.\n\nYou can choose any value between 1 week and 26 weeks. When deciding this, you should consider:\n\n* the need to protect the recipient’s personal information\n* whether the recipient will need to download the file again later\n\nIf you do not choose a value, the file will be available for the default period of 26 weeks (6 months).\n\nFiles sent before 12 April 2023 had a longer default period of 78 weeks (18 months).", + "description": "You can leave out this argument if you do not have any file to attach.\n\nTo send a file by email, add a placeholder to the template then upload a file. The placeholder will contain a secure link to download the file.\n\nThe links are unique and unguessable. GOV.UK Notify cannot access or decrypt your file.\n\nYour file will be available to download for a default period of 26 weeks (6 months).\n\nTo help protect your files you can also:\n\n* ask recipients to confirm their email address before downloading\n* choose the length of time that a file is available to download**Add contact details to the file download page**\n\n1. [Sign in to GOV.UK Notify](https://www.notifications.service.gov.uk/sign-in).\n1. Go to the __Settings__ page.\n1. In the __Email__ section, select __Manage__ on the __Send files by email__ row.\n1. Enter the contact details you want to use, and select __Save__. \n\n**Add a placeholder to the template**\n\n1. [Sign in to GOV.UK Notify](https://www.notifications.service.gov.uk/sign-in).\n1. Go to the __Templates__ page and select the relevant email template.\n1. Select __Edit__.\n1. Add a placeholder to the email template using double brackets. For example: 'Download your file at: ((link_to_file))'\n\nYour email should also tell recipients how long the file will be available to download.\n\n**Upload your file**\n\nYou can upload the following file types:\n\n- PDF (.pdf)\n- CSV (.csv)\n- Text (.odt, .txt, .rtf, .json)\n- MS Word Document (.doc, .docx)\n- Ms Excel Spreadsheet (.xlsx)\n\nYour file must be smaller than 2MB. [Contact the GOV.UK Notify team](https://www.notifications.service.gov.uk/support/ask-question-give-feedback) if you need to send other file types.\n\nYou’ll need to convert the file into a string that is base64 encoded.\n\nPass the encoded string into an object with a `file` key, and put that in the personalisation argument.\n\n**Set the filename**\n\nYou should provide a filename when you upload your file.\n\nThe filename should tell the recipient what the file contains. A memorable filename can help the recipient to find the file again later.\n\nThe filename must end with a file extension. For example, `.csv` for a CSV file. If you include the wrong file extension, recipients may not be able to open your file.\n\nThe filename should be no more that 100 characters long\n\nIf you do not provide a filename for your file, Notify will:\n\n* generate a random filename\n* try to add the correct file extension\n\nIf Notify cannot add the correct file extension, recipients may not be able to open your file.\n\n**Ask recipients to confirm their email address before they can download the file**\n\nWhen a recipient clicks the link in the email you’ve sent them, they have to enter their email address. Only someone who knows the recipient’s email address can download the file.\n\nThis security feature is turned on by default.\n\n**Turn off email address check (not recommended)**\n\nIf you do not want to use this feature, you can turn it off on a file-by-file basis.\n\nYou should not turn this feature off if you send files that contain:\n\n* personally identifiable information\n* commercially sensitive information\n* information classified as ‘OFFICIAL’ or ‘OFFICIAL-SENSITIVE’ under the [Government Security Classifications](https://www.gov.uk/government/publications/government-security-classifications) policy\n\nTo let the recipient download the file without confirming their email address, set the `confirm_email_before_download` flag to `false`.\n\n**Choose the length of time that a file is available to download**\n\nSet the number of weeks you want the file to be available using the `retention_period` key.\n\nYou can choose any value between 1 week and 26 weeks. When deciding this, you should consider:\n\n* the need to protect the recipient’s personal information\n* whether the recipient will need to download the file again later\n\nIf you do not choose a value, the file will be available for the default period of 26 weeks (6 months).", "properties": { "file": { "type": "string",