> For the complete documentation index, see [llms.txt](https://search.guides.reactify.com.au/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://search.guides.reactify.com.au/manage/product/markets.md).

# Markets

Designed to work seamlessly with the native Shopify Markets, this feature ensures that only the products you want featured are available based on where the customer is located.

This ensures that your customers have a more localised experience and are only able to shop for products available in their region. For example, you can create a market called "International" that targets Canada and Mexico. If you have a different market that you want to apply only to Japan, then you can create another market that targets only the country of Japan.

## **Prerequisites**

{% hint style="info" %}
To utilise any Markets & Inventory related merchandising, these need to be completed beforehand:

* **Front-End Version:** The front-end package should be on version 5.39.0 or later. [More info.](https://search.docs.reactify.com.au/release-notes)
* **Setup Shopify Markets:** Ensure that each market is set up in Shopify and assign the Shopify location within the app.
  {% endhint %}

## How to setup Shopify Markets

1. In Shopify, make sure to first setup up your Markets. A market can contain a single country or region, or a group of countries or regions. [More info here](https://help.shopify.com/en/manual/markets/managing-markets).<br>

   <figure><img src="/files/nNI29K0x082rTtINJGXG" alt=""><figcaption><p><strong>Shopify setup:</strong> Merchants can have one or many markets.</p></figcaption></figure>

2. In Shopify, make sure to setup your Locations. Once done, we will assign the Markets to a Location in the app.<br>

   <figure><img src="/files/mg4nBeoBr69UJyqg0rHM" alt=""><figcaption><p><strong>Shopify setup:</strong> Merchants can have one or many locations.</p></figcaption></figure>

3. In the app, initiate a sync.\ <img src="/files/1HFwgyiTzKvJii8LDngG" alt="" data-size="original"><br>

4. In the app, go to `Settings > Manage > Product`&#x20;

5. Scroll down to the `Markets` section<br>

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

6. In the Inventory Location dropdown, assigned a Shopify Location for each Market.<br>

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

7. In the app, initiate a sync.\ <img src="/files/1HFwgyiTzKvJii8LDngG" alt="" data-size="original">\
   \
   After changing the market ↔ location assignment, products will need to sync for the correct inventory/availability to be calculated. It is important to perform sync. This ensures that all products and their inclusion in a respective market are accurately reflected in the app and ultimately, on the front-end.\
   \
   Moving forward, once the markets ↔ locations are assigned, they will automatically sync from Shopify into Reactify Search via webhooks. This means that updating a location in Shopify (e.g. add a new location or delete a location) will sync through to the app automatically (same for markets).

## Merchandise based on markets

{% content-ref url="/pages/0p6sOSVYfMSJLveqVUax" %}
[Market-specific merchandising](/merchandising/collections-and-search/market-specific-merchandising.md)
{% endcontent-ref %}

{% content-ref url="/pages/OFF0MBbtII1K1iSKKKLu" %}
[Hide or show products based on Shopify Markets](/merchandising/collections-and-search/hide-or-show-products-based-on-shopify-markets.md)
{% endcontent-ref %}

{% content-ref url="/pages/C5UEDXP9HAmZyly2r3ji" %}
[Inventory Rules Based on Shopify Locations](/merchandising/collections-and-search/inventory-rules-based-on-shopify-locations.md)
{% endcontent-ref %}


---

# 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://search.guides.reactify.com.au/manage/product/markets.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.