> For the complete documentation index, see [llms.txt](https://docs.nosto.com/shopify/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nosto.com/shopify/features/outdated-asset-api-approach/adding-removing-or-moving-recommendations.md).

# Adding/Moving Recommendations

{% hint style="info" %}
Attention: This is our old approach, and not available anymore for merchants who install Nosto in May 2024 or later!
{% endhint %}

In order to move recommendations, you will need to edit your theme. Follow Shopify's instructions on [editing theme code](https://shopify.dev/themes/getting-started/customize) to edit your theme.

Use Shopify's theme editor to find the associated Liquid file to edit it. In the editor, you will need to find the corresponding placeholder, after which, you can reposition, remove or even add a new placeholder.

> **Note**: We recommend [duplicating your published theme](https://help.shopify.com/manual/using-themes/theme-files#duplicate-themes) i.e. creating a clone of the live theme, making edits on the duplicated theme and setting it as your published theme once you have validated your changes.

## List of default recommendation placeholders

Nosto places the following recommendation placeholders on the site.

|                        Element Name                       |       Theme File (OS1)      |                                       Theme File (OS2)                                      |
| :-------------------------------------------------------: | :-------------------------: | :-----------------------------------------------------------------------------------------: |
|   `<div class="nosto_element" id="frontpage-nosto-1" />`  |    templates/index.liquid   |          <p>Updated: templates/index.json<br>Added: section/nosto-index.liquid</p>          |
|   `<div class="nosto_element" id="frontpage-nosto-2" />`  |    templates/index.liquid   |           <p>Updated: emplates/index.json<br>Added: section/nosto-index.liquid</p>          |
|   `<div class="nosto_element" id="frontpage-nosto-3" />`  |    templates/index.liquid   |          <p>Updated: templates/index.json<br>Added: section/nosto-index.liquid</p>          |
|   `<div class="nosto_element" id="frontpage-nosto-4" />`  |    templates/index.liquid   |          <p>Updated: templates/index.json<br>Added: section/nosto-index.liquid</p>          |
|  `<div class="nosto_element" id="productpage-nosto-1" />` |   templates/product.liquid  |        <p>Updated: templates/product.json<br>Added: section/nosto-product.liquid</p>        |
|  `<div class="nosto_element" id="productpage-nosto-2" />` |   templates/product.liquid  |        <p>Updated: templates/product.json<br>Added: section/nosto-product.liquid</p>        |
|  `<div class="nosto_element" id="productpage-nosto-3" />` |   templates/product.liquid  |        <p>Updated: templates/product.json<br>Added: section/nosto-product.liquid</p>        |
| `<div class="nosto_element" id="categorypage-nosto-1" />` | templates/collection.liquid | <p>Updated: templates/collection.json<br>Added: section/nosto-collection-prepend.liquid</p> |
| `<div class="nosto_element" id="categorypage-nosto-2" />` | templates/collection.liquid |  <p>Updated: templates/collection.json<br>Added: section/nosto-collection-append.liquid</p> |
|  `<div class="nosto_element" id="searchpage-nosto-1" />`  |   templates/search.liquid   |     <p>Updated: templates/search.json<br>Added: section/nosto-search-prepend.liquid</p>     |
|  `<div class="nosto_element" id="searchpage-nosto-2" />`  |   templates/search.liquid   |      <p>tUpdated: emplates/search.json<br>Added: section/nosto-search-append.liquid</p>     |
|   `<div class="nosto_element" id="notfound-nosto-1" />`   |     templates/404.liquid    |            <p>Updated: templates/404.json<br>Added: section/nosto-404.liquid</p>            |
|   `<div class="nosto_element" id="notfound-nosto-2" />`   |     templates/404.liquid    |            <p>Updated: templates/404.json<br>Added: section/nosto-404.liquid</p>            |
|   `<div class="nosto_element" id="notfound-nosto-3" />`   |     templates/404.liquid    |            <p>Updated: templates/404.json<br>Added: section/nosto-404.liquid</p>            |
|   `<div class="nosto_element" id="cartpage-nosto-1" />`   |    templates/cart.liquid    |           <p>Updated: templates/cart.json<br>Added: section/nosto-cart.liquid</p>           |
|   `<div class="nosto_element" id="cartpage-nosto-2" />`   |    templates/cart.liquid    |           <p>Updated: templates/cart.json<br>Added: section/nosto-cart.liquid</p>           |
|   `<div class="nosto_element" id="cartpage-nosto-3" />`   |    templates/cart.liquid    |           <p>Updated: templates/cart.json<br>Added: section/nosto-cart.liquid</p>           |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.nosto.com/shopify/features/outdated-asset-api-approach/adding-removing-or-moving-recommendations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
