# 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 %}


---

# 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/editing-os-select+build-recipes.md?ask=<question>
```

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.