# Managing OS Select+Build recipes This guide will help you get started with creating, managing and deleting recipes in your OS Select+Build Recipe Library. The following sub-sections on this page cover:


Creating new recipes	#how-do-i-create-a-new-recipe
Finding your OS Select+Build Recipe Library	#how-do-i-find-my-os-selectbuild-recipe-library
Checking what's in a recipe	#how-do-i-check-whats-in-a-recipe
Deleting recipes	#how-do-i-delete-a-recipe

## :arrows\_clockwise: How do I create a new recipe? Before you create a data package to receive your OS NGD data, you'll need to create a recipe. {% embed url="" %} YouTube video showing how to create a recipe using OS Select+Build, add filters to the recipe, then create a data package to receive your OS NGD data. {% endembed %} To create a new recipe: {% stepper %} {% step %} #### Log into your [OS Data Hub](https://osdatahub.os.uk/) account Click *Login* on the OS Data Hub menu bar to log into your account.

{% endstep %} {% step %} #### Navigate to the OS Data Hub workspace Select *Data* from the menu bar to view your workspace. {% endstep %} {% step %} #### Navigate to the OS Select+Build Recipe Library Choose *Downloads* > *OS Select+Build Recipe Library* from the left-hand-side secondary navigation menu.

Screenshot of the OS Data Hub, showing the OS Select+Build Recipe Library screen. — Screenshot of the OS Select+Build Recipe Library screen in the OS Data Hub.

{% endstep %} {% step %} #### Choose Create a new recipe Click the *Create a new recipe* button at the top right-hand-side of the screen. {% endstep %} {% step %} #### Add details to the recipe * Give your recipe a descriptive name. * Add a detailed description for your recipe. * Select your OS NGD data by choosing the themes, collections and feature types you want to include in your recipe. * (Optional) Add filters to the feature types, if needed; more information about this is available on the [Getting started with attribute filtering page](https://docs.os.uk/osngd/getting-started/downloading-with-os-select+build/getting-started-with-recipes/getting-started-with-attribute-filtering). {% hint style="info" %} #### (Optional) Choose a data schema version If you wish to choose which schema version (where applicable) you'd like to receive the data in for a feature type, click on the feature type name within the tree view in the secondary navigation menu, then choose a data schema version from the drop-down box in the right-hand side panel. {% endhint %}

Screenshot of the OS Select+Build Recipe creator screen within the OS Data Hub, showing an example of creating a new recipe and selecting a data schema version for a feature type. — Screenshot showing an example of selecting a data schema version for a feature type in a new recipe using OS Select+Build in the OS Data Hub.

{% endstep %} {% step %} #### Finish creating the recipe Click the *Create recipe* button. Your new recipe will now instantly be available in your OS Select+Build Recipe Library. {% endstep %} {% endstepper %} {% hint style="info" %} #### Please note * We recommend defining a naming convention for your organisation before creating OS NGD recipes and / or data packages. * Adding filters to feature types is an optional step for those with advanced OS data knowledge; see the [Getting started with attribute filtering page](https://docs.os.uk/osngd/getting-started/downloading-with-os-select+build/getting-started-with-recipes/getting-started-with-attribute-filtering) for more information on applying filters and step-by-step instructions. * Selecting a data schema version for a feature type is an optional step; if you don't choose a particular data schema version for a feature type, OS Select+Build will always select the latest available data schema version for you for each feature type by default. We recommend using the pre-selected latest data schema version for feature types unless you have a specific need to use an earlier one. See the [Data schema versioning page](https://docs.os.uk/osngd/getting-started/os-ngd-fundamentals/data-schema-versioning) for more information. {% endhint %} ### What's next?


📚 Getting started with data packages	Once you've created a recipe, you'll need to add a data package against it to receive your OS NGD data. This guide takes you through creating a new data package to apply against your new recipe.	getting-started-with-data-packages

## How do I find my OS Select+Build Recipe Library? Any recipes created by your organisation will be stored in your OS Select+Build Recipe Library in the OS Data Hub. To find your OS Select+Build Recipe Library: {% stepper %} {% step %} #### Log into your [OS Data Hub](https://osdatahub.os.uk/) account Click *Login* on the OS Data Hub menu bar to log into your account.

{% endstep %} {% endstepper %} ## How do I check what's in a recipe? You can easily check details about any of your organisation's existing recipes, including a recipe's name, description, creation date, author, the filters used (if applicable), and what OS NGD themes, collections and feature types are included in a recipe. To check what's in an existing recipe: {% stepper %} {% step %} #### Log into your [OS Data Hub](https://osdatahub.os.uk/) account Click *Login* on the OS Data Hub menu bar to log into your account.

Screenshot of the OS Select+Build Recipe Library screen in the OS Data Hub.

{% endstep %} {% step %} #### Navigate to the recipe you'd like to find out more about Select the recipe you're interested in from the menu. In this view, you can see the following high-level details about a recipe: * The recipe's name * The recipe's author * The date the recipe was created * A description of the recipe, if one has been added * OS NGD theme tags to show which themes are included in the recipe In the screenshot below, you can see that the example recipe includes the following OS NGD themes: Land, Buildings, and Structures:

Screenshot of the OS Select+Build Recipe Library screen in the OS Data Hub. This screen shows high-level details about an example recipe, including the recipe name, its author, the creation date, a description of the recipe, and the OS NGD themes present within the recipe. — Screenshot of the OS Select+Build Recipe Library screen, which shows high-level details about the contents of an example recipe.

{% endstep %} {% step %} #### Find out what OS NGD themes, collections and feature types are in a recipe Clicking on a recipe opens the detailed information view, where you can find more information about the recipe, including: * The recipe's name * A description of the recipe, if one has been added * An option to view all of the filters applied to feature types in the recipe (if applicable) * The date the recipe was created * The recipe's author * An option to show the data schema version of each feature type in the recipe * A recipe tree detailing the OS NGD themes, collections, and feature types included in the recipe

Screenshot of the OS Data Hub, showing the OS Select+Build recipe details screen. This screen shows in-depth information about an example recipe, including the recipe name, a description of the recipe, the filters used, the creation date, its author, and the OS NGD themes, collections and feature types present within it. — Screenshot of the OS Select+Build Recipe details screen, which shows in-depth information about the contents of an example recipe.

{% endstep %} {% endstepper %} ## How do I delete a recipe? A recipe can be deleted within your recipe library. You can do this if you are the author of the recipe or an admin user. To delete a recipe: {% stepper %} {% step %} #### Log into your [OS Data Hub](https://osdatahub.os.uk/) account Click *Login* on the OS Data Hub menu bar to log into your account.

{% endstep %} {% step %} #### Find the recipe you want to delete In your organisation's OS Select+Build Recipe Library, scroll or search for the recipe you want to delete. {% endstep %} {% step %} #### Open the detailed recipe view Click on the *name of the recipe* to view the recipe details. In this view, you will be able to see the *Recipe actions* dropdown (where you can share, edit or delete a recipe). {% endstep %} {% step %} #### Open the recipe actions dropdown {% endstep %} {% step %} #### Delete the recipe * Click on the *name of the recipe* to view the recipe details. * If there are no data packages associated with the recipe, you will be asked to confirm the deletion of the recipe. * Where there are data packages associated, you will see the following warning: ![Screenshot of the delete recipe dialogue showing a warning about associated data packages.](https://170091638-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0pZjHxkAvY7Mn6TqFBMD%2Fuploads%2FhBva6PUsuWFH7lQIvLQC%2Fimage.png?alt=media\&token=b12b6c69-3831-47fe-9144-108c0be53c65) * Click the *Delete recipe* button*.* {% hint style="info" %} A shared recipe cannot be deleted. {% endhint %} {% endstep %} {% endstepper %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.os.uk/osngd/getting-started/downloading-with-os-select+build/getting-started-with-recipes/managing-os-select+build-recipes.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.

📚 Getting started with data packages