Change Log

This page lists changes made to OS NGD documentation. Changes will be made for a variety of reasons, including reflecting any alterations made to the OS NGD data itself as we enhance and improve the offering, plus simple improvements to the documentation to aid understanding.

The table below gives a summary of the changes made and the date upon which those changes took effect:

Version	Date	Notes
5.1	27/03/2025	New pages added for the March 2025 OS NGD data enhancements release: Pages added for the new Building Access Location, Crowd Sourced Name Point, and Street Light Feature Types. Eighteen new code lists added: Roof Material Value, Roof Shape Value, Roof Confidence Indicator Value, Physical State Value, Access Mode Value, Access Purpose Value, Access Obstruction Value, Access Level Value, Building Access Location Description Value, Network Node Feature Type Value, Street Light Description Value, Link Reference Confidence Value, Transport Feature Type Value, Illumination Value, Crowd Sourced Name Description Value, Crowd Sourced Name Match Type Value, Matched Feature Type NGD Value and Matched Theme NGD Value. Existing pages amended with information about the March 2025 OS NGD data enhancements: Four major data schema versions released for existing feature types: Building (v4.0), Path Link (v2.0), Road Link (v4.0), Site Access Location (v2.0): Updates made to the Building Feature Type page to reflect the new attribution for Roof Shape, Roof Aspect, Roof Material, Solar Panel Presence, Green Roof Presence and Building Height, as supplied with data schema version 4.0. Updates made to the Path Link Feature Type page to reflect the addition of new Street Light attribution, as supplied with data schema version 2.0. Updates made to the Road Link Feature Type page to reflect the addition of new Street Light attribution, as supplied with data schema version 4.0. Updates made to the Site Access Location Feature Type page to reflect new Access Purpose attribution, as supplied with data schema version 2.0. Seven minor data schema versions released for existing feature types: Building Part (v2.1), Land (v3.1), Rail (v3.1), Road Track Or Path (v3.1), Site (v2.2), Structure (v3.1) and Water (v3.1). Four code lists updated: Built Structure Height Confidence Value, Site Description Value, Site Access Location Description Value and Compound Structure Description Value. Updates made to the OS NGD Buildings pages (in the ‘USING NGD DATA’ section) to reflect the release of the new Building Access Location Feature Type (v1.0) and the addition of new attribution in the Building Feature Type (v4.0) for Roof Shape, Roof Aspect, Roof Material, Solar Panel Presence, Green Roof Presence and Building Height. Updates made to the OS NGD Transport pages (in the ‘USING NGD DATA’ section) to reflect the addition of the new Street Light Feature Type to the OS NGD Transport Features Collection and the addition of new Street Light attribution in the Path Link Feature Type (v2.0) and Road Link Feature Type (v4.0). Updates made to the following three OS NGD theme pages: Buildings, Geographical Names, and Transport. Updates made to the following five OS NGD collection pages: Building Features, Land Use Features, Named Features, Transport Features, and Transport Network. Updates made to the following pages: What's New?, Current Known Data Issues, Core Principles – Data schema versioning, Core Principles – Data ordering and currency, Future OS NGD Data Enhancements, OS NGD Webinars, Tutorials and Case Studies, OS NGD API – Features – What data is available? and FAQs.
5.0	25/03/2025	OS Premium Download Products section deleted from the OS NGD Documentation site. Documentation for the OS Multi-modal Routing Network (OS MRN) and OS Emergency Services Gazetteer (OS ESG) products was moved to the OS Download Products' Documentation site.
4.9	13/03/2025	Updates made to the OS NGD Sample Data Information page to reflect the release of new sample data connected to the March 2025 OS NGD data enhancements for the following OS NGD collections: Building Features, Land Use Features, Named Features, Structure Features, Transport Features, and Transport Network.
4.8	11/03/2025	Publication of new page: Live Service Disruption and Planned Maintenance.
4.7	06/02/2025	Former 'Known Data Issues' page split into two pages: Current Known Data Issues and Resolved Data Issues.
4.6	26/09/2024	New pages added for the September 2024 OS NGD data enhancements release: Six new code lists added: Address Classification Source Value, Classification Correlation Value, Matched UPRN Value, Network Over Under Bridge Value, Status Value, and Yes No Value. Existing pages amended with information about the September 2024 OS NGD data enhancements: Updates made to the Building Part, Land, Rail, Road Link, Road Track Or Path, Site, Structure, and Water Feature Type pages to reflect new attribution for land use, as supplied with data schema version 3.0 for all feature types bar Building Part and Site, which are supplied with data schema version 2.0. Updates made to the Compound Structure Feature Type page to reflect new attribution for bridge interactions, as supplied with data schema version 2.0. Updates made to the Building Feature Type page to reflect new Number of Floors attribution, as supplied with data schema version 3.0. Three code lists updated: Building Part Description Value, Compound Structure Description Value and Relationship Type Value. Updates made to the OS NGD Buildings pages (in the USING NGD DATA section) to reflect new Number of Floors attribution in data schema version 3.0 of the Building Feature Type. Updates to the 'What's New?', 'Known data issues', 'Product announcements', 'Core Principles', 'Future OS NGD Data Enhancements', and 'Sample data' pages. Updates made to the following OS NGD collection pages: Structure Features, Land Features, Land Use Features, Building Features, Transport Features and Water Features.
4.5	27/03/2024	New pages added for the March 2024 OS NGD data enhancements release: Pages added for the new Field Boundary, Named Road Junction, and Tram On Road Feature Types, together with pages for their associated new code lists. New sections added to the USING NGD DATA section for OS NGD Land cover enhancements, OS NGD Structures and OS NGD Transport. Existing pages amended with information about the March 2024 OS NGD data enhancements: Updates made to the Land, Rail, Road Link, Road Track Or Path, Structure, and Water Feature Type pages to reflect new attribution for land cover, as supplied with data schema version 2.0 for all feature types bar Road Link, which is supplied with data schema version 3.0. Updates to the 'What's New?', 'Product announcements', 'Future OS NGD Data Enhancements', and 'Sample data' pages.
4.4	28/09/2023	New pages added for the September 2023 OS NGD data enhancements release: Pages added for the new Building, Railway Link, Railway Link Set, Railway Node, and Pavement Link Feature Types, together with their associated new code lists. Existing pages amended with information about the September 2023 OS NGD data enhancements: Updates made to the Road Link Feature Type page to reflect the new attribution for pavement presence, as supplied with data schema version 2.0. New section added to the USING NGD DATA section for OS NGD Buildings. Updates to the 'What's New?', 'Product announcements', 'Future OS NGD Data Enhancements', and 'Sample data' pages. Updates made to the OS NGD Building Features and OS NGD Transport Network Collection pages
4.3	10/08/2023	Changes introduced to reflect expansion of coverage from urban paths only to GB-wide coverage.
4.2	21/06/2023	New page added to the GETTING STARTED section: 'OS NGD Talks, Webinars, Tutorial Videos and Case Studies'.
4.1	19/06/2023	Temporal filtering sub-section wording updated on the feature type pages of eight feature types in the OS NGD Addressing Theme in the DATA STRUCTURE section. The earliest and latest dates on which you can request a one-off snapshot of a date in the past for the data schema versions available for these feature types are now documented. Example images added to all OS NGD Collection pages (in the DATA STRUCTURE section) to show what the different feature types in the collections look like in the data. A background map has been included in each image to provide context. Example images added to the 'Average And Indicative Speed', 'Highway Dedication' and 'Restriction' Feature Types pages (of the RAMI Collection) to show what the different feature types look like in the data. A background map has been included in each image to provide context.
4.0	15/06/2023	Definition expanded for the Average And Indicative Speed Feature Type (of the RAMI Collection). Road Link Direction attribute (RAMI Collection, attribute for the Restriction Feature Type) definition updated from ‘The direction in which the restriction applies in direction of digitisation of the Road Link feature.’ to ‘The direction in which the restriction applies in relation to the direction of digitisation of a Road Link feature'. Directionality attribute (Transport Network Collection, attribute for the Road Link Feature Type) definition updated from ‘Indication of the direction of traffic flow.’ to ‘Indication of the direction of traffic flow in relation to the direction of digitisation of a Road Link feature'. Three missing definition values entered in the Link Direction value code list and final sentence of code list definition expanded.
3.9	12/06/2023	New warning note added to the 'Site Routing Point Feature Type' page under the feature type description at the top of the page. Information note added to the 'Road Node Feature Type' page under the feature type description at the top of the page. Fifth reason added for one of the General FAQs on the FAQs page ('Why am I receiving blank files?' FAQ), relating to the Site Routing Point Feature Type being an 'end of life' feature type as of late spring 2023.
3.8	07/06/2023	New announcement added to 'Product Announcement' page: 'June 2023: 5 days of system downtime for feature types'.
3.7	25/05/2023	New images added to the 'Homepage', 'What's New?', 'Terminology and access', and 'OS NGD Future Data Enhancements' pages.
3.6	03/05/2023	One YouTube video added to the 'Accessing OS NGD APIs' page; the video gives instructions on how to add OS NGD API – Tiles to a new project on the OS Data Hub and generate an API key. One YouTube video added to the 'Getting Started with Attribute Filtering' page and the 'Getting Started with Temporal Filtering' page; the video gives instructions on how to get started with both attribute filtering and temporal filtering in OS Select+Build.
3.5	21/04/2023	'Known Data Issues' page: New section and table added for 'OS NGD Transport Theme known data issues' to document an 'Incorrect speed values' issue.
3.4	06/04/2023	New page added to 'DATA STRUCTURE' section: 'Product Announcements'. New section ('How do I check if filters are used in an existing recipe?') added to the 'Getting Started with Attribute Filtering' sub-page in the 'Accessing OS NGD' section.
3.3	05/04/2023	New sub-page added to the 'Downloading with OS Select+Build' page in the 'Accessing OS NGD' section: 'Getting Started with Temporal Filtering'.
3.2	03/04/2023	More information added about default coordinate reference systems available for the RAMI, Water Network and Transport Network Collections on their retrospective collection pages in the Data Structure section and in the 'Coordinate reference systems' page in the OS NGD Core Principles section.
3.1	30/03/2023	Recipe sharing information added to the 'What's New?' page and the 'Downloading with OS Select+Build' page.
3	29/03/2023	New pages published: 'Data schema versioning' and 'What's New?' (both within the Getting Started section); 'Versioning information' (within OS NGD Address in the Data Structure section). Existing pages amended with information about the March 2023 OS NGD data enhancements: 'OS NGD Key Benefits to Customers'; 'Core Principles'; 'Downloading with OS Select+Build'; 'Accessing OS NGD APIs'; 'Using Code Examples'; Theme pages for Address, Transport and Water; all 13 Collection pages; 'Known Data Issues'; 'Data Catalogue'; 'FAQs'; 'Future OS NGD Data Enhancements'. Coming soon banner removed from all relevant addressing feature type pages and from the Average And Indicative Speed, Waterbody Catchment, and River Basin District Catchment Feature Type pages.
2.9	23/03/2023	Diagrams added to the 'Water Link' and 'Water Link Set' Feature Type pages (within the DATA STRUCTURE section) to show how these features look in OS NGD data.
2.8	10/03/2023	New pages published for the Average And Indicative Speed Feature Type (within the RAMI Collection of the OS NGD Transport Theme), Capture Method Value Code List, and Average And Indicative Speed Description Value Code List. New pages published for the Waterbody Catchment Feature Type and River Basin District Catchment Feature Type (both within the Water Features Collection of the OS NGD Water Theme), Waterbody Category Value Code List, Waterbody Catchment Description Value Code List, and River Basin District Catchment Description Value Code List. Existing pages updated to include data schema version 2 information and new attributes for the Built Address, Historic Address, Non-Addressable Object and Pre-Build Address Feature Types in both the GB Address and Islands Address Collections (within the OS NGD Address Theme). The Related Entity Related Component page was also updated to include data schema version 2 information and new attributes.
2.7	08/03/2023	'Known Data Issues' page: Section and table removed for 'OS NGD Transport Theme known data issues' as these have been resolved. 'Daily COU updates temporarily paused' row removed from 'OS NGD Address Theme known data issues' table as this issue has been resolved. Page title change from 'Accessing OS NGD API – Features' to 'Accessing OS NGD APIs' in the DATA STRUCTURE section.
2.6	06/03/2023	Temporal filtering information added to the top of all 81 feature type pages (detailing the earliest date on which you can request a one-off snapshot of a date in the past for data in each feature type). Temporal filtering information generalised on all 13 collection pages, pointing users to individual feature type pages to get dates instead.
2.5	03/03/2023	Content published on the 'Getting Started with Attribute Filtering' page.
2.4	22/02/2023	Order of pages amended in the 'Core Principles' section and new placeholder page on 'Data schema versioning' added to this section. New placeholder page on 'What's New' added to 'GETTING STARTED' section. New placeholder page 'Versioning information' added to 'DATA STRUCTURE' section for the Addressing Theme. Geometry type corrected from Polygon to MultiPolygon for the Geometry attribute of all feature types in the Boundaries Collection (apart from the Boundary High Water Mark, GLA Assembly Constituency and Regional Authority Feature Types).
2.3	20/02/2023	'Known Data Issues' page: New section and table added for the OS NGD Transport Theme known data issues. New row added to the OS NGD Address Theme known data issues table ('Daily COU updates temporarily paused').
2.2	30/11/2022	Missing definitions added to the 'Structure Land Cover Tier A Value' and 'Structure Land Cover Tier B Value' Code Lists.
2.1	25/11/2022	New section added to the 'Known Data Issues' page for the OS NGD Administrative and Statistical Units Theme.
2	17/11/2022	'Known Data Issues' page added to the Data Structure section. Updates made to the 'Coordinate Reference Systems' page: table added outlining the default coordinate reference system used by each OS NGD collection; note deleted; OS Select+Build list of coordinate reference systems altered by removing World Geodetic System (WGS84: EPSG: 4326) and inserting European Terrestrial Reference System (ETRS89: EPSG: 4258). New OS Select+Build FAQ added to the 'FAQs' page ('How do I identify the correct OS NGD collection for calculating usage?').
1.9	16/11/2022	Updates made to the 'Sample Data Information' page to mention that sample data is now available for the OS NGD GB Address Collection. Sample data is available for 12 of the 13 OS NGD collections. Note added to say that sample data won't be released for the OS NGD Islands Address Collection. Wording updated for two of the General FAQs on the 'FAQs' page ('Why am I receiving blank files?' FAQ and the 'Why do I have different start dates when applying temporal filters to different feature types?' FAQ).
1.8	08/11/2022	New General FAQ added to the 'FAQs' page ('What are the default coordinate reference systems used by the OS NGD collections?'). New sections added to the 13 OS NGD collection pages on earliest temporal filtering date and default coordinate reference systems.
1.7	04/11/2022	New note added to the 'Data ordering and currency' page about geographic filtering supply options. Note added to the 'Related Components' page. New note added to the 'COU supplies' page about features moving between OS NGD themes and between OS NGD feature types. Introductory sentence added above the CSV structure table on the 'File formats and naming' page. Definition added for the 'Made Surface' label in the 'Rail Description Value' Code List. The maintenanceauthority_authorityname attribute's definition was corrected from 'The authority responsible for the street naming and numbering or maintenance' to 'The authority responsible for maintenance.'
1.6	03/11/2022	Formatting changes on the 'FAQs' page to include expandable blocks. Minor changes to two labels in the 'Land Description Value' Code List: 'Heath Or Rough Grassland And Scattered Boulders or Scattered Rock' was changed to 'Heath Or Rough Grassland And Scattered Rock'; and 'Heath Or Rough Grassland And Scattered Boulders or Scattered Rock And Scrub' was changed to 'Heath Or Rough Grassland And Scattered Rock And Scrub'.
1.5	01/11/2022	Note (saying that ''the Address Theme will be launched later this year'') removed from the top of the OS NGD Address Theme, GB Address Collection and Islands Address Collection pages as the Address Theme went live to customers in OS Select+Build on 31/10/2022. Correction made to the feature type description on the Connecting Link Feature Type page to say that a Connecting Link does not represent a feature in the real world.
1.4	28/10/2022	Updates made to the 'OS NGD Sample Data Information' page to mention that sample data is now available for the OS NGD Boundaries Collection. Sample data is available for 11 of the 13 OS NGD collections.
1.3	21/10/2022	Updates made to the 'OS NGD Sample Data Information' page to mention that sample data is now available for the OS NGD Water Network, Transport Network, Named Features, and Routing and Asset Management Information (RAMI) Collections. Sample data is available for 10 of the 13 OS NGD collections.
1.2	14/10/2022	Amendments made to the instructions for loading CSV files into an Oracle database in the 'Loading CSV files' page.
1.1	11/10/2022	'Data Entity Catalogue' Code List updated to remove OS NGD Landform label and insert OS NGD Rail label. 'OS Land Use Tier B Value' Code List updated to include previously unavailable definitions for all bar five labels. 'Accessibility' page added to the EXTRA LINKS section. Additional instructions added to the 'Downloading with OS Select+Build' page on downloading data packages. Two YouTube videos added to the 'Downloading with OS Select+Build' page; the videos give instructions on how to create a new recipe using OS Select+Build, and how to create and download a data package using OS Select+Build. One YouTube video added to the 'Accessing OS NGD APIs' page; the video gives instructions on how to add OS NGD API – Features to a new project on the OS Data Hub and generate an API key.
1	29/09/2022	OS NGD official launch to customers.
0.3	25/08/2022 to 29/09/2022	Amendments to multiple pages and publication of new pages in preparation for OS NGD launch.
0.2	24/08/2022	Amendments to multiple pages in preparation for the first set of OS NGD sample data being released.
0.1	12/05/2022	Pre-release of OS NGD documentation on the OS NGD Documentation Platform.