# Editing OS Select+Build recipes

You can edit the content of an existing recipe (i.e. add or remove themes / feature types, or change attribute filtering or data schema versions) and you can edit the name or description of an existing recipe.

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>Editing recipe names</strong></td><td><a href="#how-do-i-edit-the-name-of-my-recipe">#how-do-i-edit-the-name-of-my-recipe</a></td></tr><tr><td><strong>Editing recipe descriptions</strong></td><td><a href="../sharing-os-select+build-recipes#how-do-i-accept-a-recipe-shared-with-me">#how-do-i-accept-a-recipe-shared-with-me</a></td></tr><tr><td><strong>Editing the content of recipes</strong></td><td><a href="#how-do-i-edit-a-recipe">#how-do-i-edit-a-recipe</a></td></tr></tbody></table>

## How do I edit the name of my recipe?

To edit a recipe's name:

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

#### Select the recipe you want to edit

In your organisation's OS Select+Build Recipe Library, scroll or search for the recipe you want to edit.
{% endstep %}

{% step %}

#### View recipe details

Click on the *name of the recipe* to view the recipe details.
{% endstep %}

{% step %}

#### Click the edit icon next to the recipe name

Click on the *pencil icon* next to the recipe name.
{% endstep %}

{% step %}

#### Change the name of the recipe

Enter the required changes to the recipe name in the dialog box.
{% endstep %}

{% step %}

#### Save changes to the recipe

To save your changes, simply click away from the edit box. *The recipe's change log at the bottom of the page will update to reflect the change to the recipe name.*
{% endstep %}
{% endstepper %}

## How do I edit the description of my recipe?

To edit a recipe's description:

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

#### Select the recipe you want to edit

In your organisation's OS Select+Build Recipe Library, scroll or search for the recipe you want to edit.
{% endstep %}

{% step %}

#### View recipe details

Click on the *name of the recipe* to view the recipe details.
{% endstep %}

{% step %}

#### Click the edit icon next to the recipe name

Click on the *pencil icon* next to the recipe name.
{% endstep %}

{% step %}

#### Change the description of the recipe

Enter the required changes to the recipe description in the dialog box.
{% endstep %}

{% step %}

#### Save changes to the recipe

To save your changes, simply click away from the edit box. *The recipe's change log at the bottom of the page will update to reflect the change to the recipe description.*
{% endstep %}
{% endstepper %}

## How do I edit a recipe?

You can edit the content of a recipe to add or remove themes and feature types, change attribute filtering or switch between data schema versions. However, you can't edit a recipe if it has data packages linked to it that receive change-only updates (COUs) – please see the warning note below for instructions on how to solve this issue and create a copy of a recipe.

To edit a recipe that doesn't have data packages linked to it that receive COUs:

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

#### Select the recipe you want to edit from the list

In your organisation's Recipe Library, scroll or search for the recipe you want to edit.
{% endstep %}

{% step %}

#### Edit recipe data

Click on the recipe you plan to edit to add and remove themes and feature types, or change attribute filtering or data schema versions.

<figure><img src="https://170091638-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0pZjHxkAvY7Mn6TqFBMD%2Fuploads%2F2DTno47D9Z4EJy3FNVzJ%2FScreenshot%20Editing%20a%20recipe.png?alt=media&#x26;token=9b4b7edc-7c4c-4d07-988b-7cb3641bd2e3" alt="Screenshot of the OS Select+Build Recipe details screen in the OS Data Hub, with the Recipe actions dropdown showing where you can share, edit or delete a recipe."><figcaption><p>Screenshot of the OS Select+Build Recipe details screen with the Recipe actions dropdown open, showing where you can share, edit or delete a recipe.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Save changes to your recipe

Add a description of the change you have made, then select *Save changes.*
{% endstep %}
{% endstepper %}

{% hint style="warning" %}

## Recipes with data packages linked to them that receive COUs

**You can't edit a recipe if it has data packages linked to it that receive change-only updates (COUs)**. To get round this issue, you'll need to create a copy of the recipe and then edit that copy.

To create a copy of a recipe:

* Log into your [OS Data Hub](https://osdatahub.os.uk/) account.
* Select *Data* from the main menu.
* Choose *Downloads* > *OS Select+Build Recipe Library* from the secondary navigation menu.
* From your list of recipes, click on the name of the recipe you wish to edit, then click on the *Recipe actions* dropdown and select *Edit recipe*.
* When the 'Recipe cannot be edited' warning pop up appears, click the *Copy recipe* button.

<img src="https://170091638-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0pZjHxkAvY7Mn6TqFBMD%2Fuploads%2F4SNPX4Lyqj6GbmbNWSYH%2FScreenshot%20Create%20a%20copy%20of%20a%20recipe.png?alt=media&#x26;token=5316c6b6-cc29-4c72-802c-1da8289ba170" alt="Screenshot of the OS Data Hub &#x27;Recipe cannot be edited&#x27; warning pop up in OS Select+Build." data-size="original">

* Choose a suitable name for your copied recipe, then click *Create recipe*.

The copied recipe will appear in your OS Select+Build Recipe Library and you can now edit it following the ['How do I edit a recipe?' steps outlined above](#how-do-i-edit-a-recipe).
{% endhint %}