# 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:

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Creating new recipes</strong></td><td><a href="#how-do-i-create-a-new-recipe">#how-do-i-create-a-new-recipe</a></td></tr><tr><td><strong>Finding your OS Select+Build Recipe Library</strong></td><td><a href="#how-do-i-find-my-os-selectbuild-recipe-library">#how-do-i-find-my-os-selectbuild-recipe-library</a></td></tr><tr><td><strong>Checking what's in a recipe</strong></td><td><a href="#how-do-i-check-whats-in-a-recipe">#how-do-i-check-whats-in-a-recipe</a></td></tr><tr><td><strong>Deleting recipes</strong></td><td><a href="#how-do-i-delete-a-recipe">#how-do-i-delete-a-recipe</a></td></tr></tbody></table>

## How do I create a new recipe?&#x20;

Before you create a data package to receive your OS NGD data, you'll need to create a recipe.

{% embed url="<https://youtu.be/_6ubf-8VAUk>" %}
YouTube video showing how to create a recipe using OS Select+Build.
{% endembed %}

{% 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.

<figure><img src="https://170091638-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0pZjHxkAvY7Mn6TqFBMD%2Fuploads%2F1Gd3vBvSOqXLYTPpZsO9%2Fimage.png?alt=media&#x26;token=afd47dd4-6005-4d33-a8ef-ec6540a138fb" alt="A screenshot of the OS Data Hub home page showing the sign up and log in buttons in the top right hand corner" width="563"><figcaption><p>Screenshot showing the OS Data Hub homepage.</p></figcaption></figure>
{% 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.
{% 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.&#x20;
* (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 %}

<figure><img src="https://170091638-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0pZjHxkAvY7Mn6TqFBMD%2Fuploads%2FACGZcwcg4GECMjplipY9%2FScreenshot%20showing%20creating%20recipe%20and%20selecting%20data%20schema%20version.png?alt=media&#x26;token=d91e3970-4e7c-4ce0-9143-46eb0beac844" alt="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." width="563"><figcaption><p>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.</p></figcaption></figure>
{% 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. 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?

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h3><span data-gb-custom-inline data-tag="emoji" data-code="1f4da">📚</span> Getting started with data packages</h3></td><td>Once you've created a recipe, you'll need to create a data package against it to receive your OS NGD data.<br><br>This guide takes you through creating a new data package to apply against your newly created recipe.</td><td><a href="../getting-started-with-data-packages">getting-started-with-data-packages</a></td></tr></tbody></table>

## 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.&#x20;

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.

<figure><img src="https://170091638-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0pZjHxkAvY7Mn6TqFBMD%2Fuploads%2F1Gd3vBvSOqXLYTPpZsO9%2Fimage.png?alt=media&#x26;token=afd47dd4-6005-4d33-a8ef-ec6540a138fb" alt="A screenshot of the OS Data Hub home page showing the sign up and log in buttons in the top right hand corner" width="563"><figcaption><p>Screenshot showing the OS Data Hub homepage.</p></figcaption></figure>
{% 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 secondary navigation menu. You will then be taken to your organisation's OS Select+Build Recipe Library.

<figure><img src="https://170091638-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0pZjHxkAvY7Mn6TqFBMD%2Fuploads%2FamiHxVEA8ivdYWmhdcR0%2FScreenshot%20Recipe%20Library.png?alt=media&#x26;token=1bd9e5df-cb7d-45c5-8f08-3c1ab13b25f1" alt="Screenshot of the OS Data Hub, showing the OS Select+Build Recipe Library screen."><figcaption><p>Screenshot of the OS Select+Build Recipe Library screen in the OS Data Hub.</p></figcaption></figure>
{% 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.&#x20;

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.

<figure><img src="https://170091638-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0pZjHxkAvY7Mn6TqFBMD%2Fuploads%2F1Gd3vBvSOqXLYTPpZsO9%2Fimage.png?alt=media&#x26;token=afd47dd4-6005-4d33-a8ef-ec6540a138fb" alt="A screenshot of the OS Data Hub home page showing the sign up and log in buttons in the top right hand corner" width="563"><figcaption><p>Screenshot showing the OS Data Hub homepage.</p></figcaption></figure>
{% 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 secondary navigation menu. You will then be taken to your organisation's OS Select+Build Recipe Library.

<figure><img src="https://170091638-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0pZjHxkAvY7Mn6TqFBMD%2Fuploads%2FamiHxVEA8ivdYWmhdcR0%2FScreenshot%20Recipe%20Library.png?alt=media&#x26;token=1bd9e5df-cb7d-45c5-8f08-3c1ab13b25f1" alt="Screenshot of the OS Select+Build Recipe Library screen in the OS Data Hub."><figcaption><p>Screenshot of the OS Select+Build Recipe Library screen in the OS Data Hub.</p></figcaption></figure>
{% 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:<br>

<figure><img src="https://170091638-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0pZjHxkAvY7Mn6TqFBMD%2Fuploads%2FwXwphydnkXqJmpbyn5Rn%2FTest-Example-recipe.PNG?alt=media&#x26;token=17ae92be-a246-47f6-b679-ff7e214110a1" alt="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." width="509"><figcaption><p>Screenshot of the OS Select+Build Recipe Library screen, which shows high-level details about the contents of an example recipe.</p></figcaption></figure>
{% 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

<figure><img src="https://170091638-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0pZjHxkAvY7Mn6TqFBMD%2Fuploads%2F6WNNY3LvNZ9yNw1I4PCJ%2FScreenshot%20example%20filtered%20recipe.png?alt=media&#x26;token=14309000-7840-4de4-8bf8-b5f6fdd4d0d5" alt="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." width="563"><figcaption><p>Screenshot of the OS Select+Build Recipe details screen, which shows in-depth information about the contents of an example recipe.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## How do I delete a recipe?&#x20;

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.&#x20;

To delete a recipe:&#x20;

{% 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.

<figure><img src="https://170091638-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0pZjHxkAvY7Mn6TqFBMD%2Fuploads%2F1Gd3vBvSOqXLYTPpZsO9%2Fimage.png?alt=media&#x26;token=afd47dd4-6005-4d33-a8ef-ec6540a138fb" alt="A screenshot of the OS Data Hub home page showing the sign up and log in buttons in the top right hand corner" width="563"><figcaption><p>Screenshot showing the OS Data Hub homepage.</p></figcaption></figure>
{% 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 secondary navigation menu. You will then be taken to your organisation's OS Select+Build Recipe Library.

<figure><img src="https://170091638-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0pZjHxkAvY7Mn6TqFBMD%2Fuploads%2FamiHxVEA8ivdYWmhdcR0%2FScreenshot%20Recipe%20Library.png?alt=media&#x26;token=1bd9e5df-cb7d-45c5-8f08-3c1ab13b25f1" alt="Screenshot of the OS Select+Build Recipe Library screen in the OS Data Hub."><figcaption><p>Screenshot of the OS Select+Build Recipe Library screen in the OS Data Hub.</p></figcaption></figure>
{% 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) &#x20;
* Click the *Delete recipe* butto&#x6E;*.*

{% hint style="info" %}
A shared recipe cannot be deleted.
{% endhint %}
{% endstep %}
{% endstepper %}