Skip to main content
A product catalog gives your assistant the products, prices, and availability it needs for recommendations. Use a product feed to keep it up to date, or connect your Shopify store. Your knowledge stores provide the supporting information, such as shipping policies, FAQs, and sizing advice. You manage them separately from the catalog.

Catalogs and markets

Start with one catalog and one market. Add more markets when countries need different assortments, prices, or availability. For another language with the same assortment and prices, add a translation.

Create a catalog

1

Open Product catalogs

In the homie platform, open Product catalogs, select Create, and choose Catalog in the Add product catalog dialog.
2

Name the catalog

Under New catalog, enter a name you can recognize, such as your shop’s name, and select Create.
3

Add the first market

Load your product feed and review the suggested fields. Follow Product feed and field mapping to set the market’s language, countries, currency, and import schedule.The first market automatically becomes the catalog’s default market. It also serves countries without their own market unless you change this in the catalog settings.
4

Check the import

Select Create market. After the import finishes, open Products and check a few familiar products, including their prices, links, and availability.
Next, choose the catalog for an assistant so it can recommend these products.

Manage a catalog

Product catalogs lists your organization’s catalogs and connected Shopify stores. A catalog with the badge No market still needs its first market. Manage Shopify connections under Integrations. Open a catalog to access:
  • Overview — product and market counts, the latest import, and assistants using the catalog.
  • Markets — add markets or open an existing market to manage its feed and translations.
  • Products — check the products available to your assistants.
  • Supplemental data — manage price lists, promotions, and ratings.
  • Settings → General — rename the catalog, choose its default market, or delete it.

Catalog overview

Check Market status for anything that needs attention, such as a failed import or an incomplete field mapping. Select an entry to open the place where you can fix it. When no issues are reported, you see All markets are up to date. For import errors and files that cannot be loaded, see Imports and safeguards.

Find and check products

1

Choose a market and language

Open Products and choose Market and Language. If a product has no translation in that language, its original text appears.
2

Choose how to search

Under Search, choose Free search and enter a customer question, or choose ID search and enter product IDs, GTINs, or other searchable identifiers. Separate multiple IDs with commas. Unmatched IDs appear above the results.
3

Check the result

Review the product details for the selected market. If the first import failed, select Go to import report to see what needs fixing.

Choose a catalog for an assistant

1

Open the product source

Open your assistant and go to Knowledge sources → Products.
2

Select the catalog

Choose Catalog and select a catalog under Select catalog…. Markets of this catalog shows its markets and default market. Use Create new catalog if you need another catalog.
3

Set country and customer group

  • Default country — used when your website does not provide a country. Choose Default market of the catalog to use the catalog’s default instead. See Markets and countries.
  • Customer group — optionally select a group to use its price list, for example for an assistant in your trade portal.
4

Choose how to show availability

  • Mention exact stock — allow the assistant to name the quantity in stock. Off by default; otherwise it only knows whether the product is available.
  • Show unavailable products — include products that cannot currently be ordered. Off by default. When enabled, the assistant prefers available products unless an unavailable product fits the request much better.
Check your availability mapping: without availability or stock information, all products count as available.
5

Save and test

Select Save to save the product source and these settings together. Test a product question in the Playground, including the country and language your customers use.

Choose a Shopify store for an assistant

First connect your Shopify store. If you have several connected stores, choose the one whose products the assistant should recommend.
1

Open the product source

Open your assistant and go to Knowledge sources → Products.
2

Select the store

Choose Shopify, then select a connected store under Shopify store.
3

Save and test

Select Save and test a product question in the Playground. Product recommendations and Shopify conversion analytics use the selected store.
Other Shopify domain lets you enter a Shopify store that is not connected to your organization. homie checks the domain before saving. Connect the store through Integrations to use the connected store’s integration features.

Delete a catalog

Open Settings → General and select Delete catalog. Review the confirmation before deleting.
Deleting a catalog permanently removes its markets, products, translations, import history, and supplemental data. Assistants using it stop recommending products until you assign another product source.

Next steps

Markets and countries

Set up countries and languages for your shop.

Product feed and field mapping

Connect a feed and choose the product information to use.

Supplemental data

Add price lists, promotions, and ratings.

Imports and safeguards

Keep products current and resolve import problems.