> For the complete documentation index, see [llms.txt](https://galmis.gitbook.io/serializer-product-tracking/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://galmis.gitbook.io/serializer-product-tracking/getting-started/sharing-and-integration/share-item-information-with-customers/dynamically-display-items-in-your-online-store.md).

# Dynamically display items in your online store

The app provides a secure API, which can be used to extend your online store with item lookup capability, similar to the search functionality on the "[Sold items](/serializer-product-tracking/getting-started/item-management/manage-sold-items/view-all-sold-items.md)" page in the app. This may be useful to merchants wanting their customers to verify the authenticity of their purchased items.

{% hint style="info" %}
To implement item search functionality on the storefront, basic knowledge of Javascript and Shopify Liquid programming languages is required. See the [development API reference](/serializer-product-tracking/getting-started/sharing-and-integration/development-api-reference/app-proxy-rest-api.md) for more details.
{% endhint %}

## write\_app\_proxy access scope

In order to provide the items lookup capability, the app needs the `write_app_proxy` access scope, i.e. a permission to&#x20;

"*View and edit store data*

*Edit your Online Store*

*Online Store page content on a path controlled by the app*"

<figure><img src="/files/TfePoLYwsMmtApVNsMlq" alt=""><figcaption></figcaption></figure>

**Unfortunately, the access scope is required even if your store doesn't rely on the app proxy.**&#x20;

According to [Shopify's documentation](https://shopify.dev/docs/apps/build/online-store/display-dynamic-data#liquid-response), "*App proxies support* [*Liquid*](https://shopify.dev/docs/api/liquid)*, Shopify's template language. An app proxy response that contains Liquid will be rendered with store data into HTML like it was part of the store's theme.*"

Please note that even though the app requires the access scope, **it doesn't automatically make any changes to your storefront's content, even if your online store uses the app proxy**. The API only returns data in JSON format and not Liquid. However, you can implement custom solutions, which would present such data to your customers.&#x20;


---

# 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://galmis.gitbook.io/serializer-product-tracking/getting-started/sharing-and-integration/share-item-information-with-customers/dynamically-display-items-in-your-online-store.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.
