> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yourhomie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Imports and safeguards

> How markets and supplemental data stay current, what the import report shows, and how homie protects your products from incomplete or unreachable files.

homie imports every market automatically as often as you set under **Automatic import**, together with the supplemental data that applies to it. When an import brings new or changed products, the market's translations are applied to them right after it. This keeps recommendations aligned with your shop. Until an import is complete, the last state of your products stays active.

## Update a market

* **Automatically:** choose the **Frequency** in the **Automatic import** card when you add the market: **Daily** at a **Time** in your time zone, **Hourly** (on a higher plan), or **Manual only**. Later, you change it in the market's **Settings** tab in the same card.
* **Right away:** in the market's **Imports** tab or at the top of the market's page, **Start import** triggers an import yourself. You can start an import every 5 minutes.
* **After changes:** when you save a changed field mapping, a new product feed URL, a changed language or currency, or a supplemental data source, a new import starts automatically. A saved translation applies on its own, without an import, unless it changes which columns of the product feed a **This feed** translation reads (see [Translations](https://docs.yourhomie.ai/en/user-guide/knowledge/catalog/markets.md#translations)).

While an import runs, the market's overview shows its progress. Until it finishes, the assistant uses the previous product data.

## Review imports

**1. Open the report**

Open the market's **Imports** tab and select **Report** for the import you want to check. **Import history** lists the market's imports, newest first; select **Load more** to see older ones. The overview also lists **Recent imports**.

**2. Check the result**

Review the status and the counts under **New**, **Changed**, **Removed**, and **Rejected**. Under **Needs attention**, follow the links to the settings that need correcting. **Everything looks good** means the report found no issues requiring action.

**3. Fix rejected rows**

Check each affected product ID and the reason under **Rejected**. Correct missing product details, invalid values, or the field mapping, then select **Start import** to try again.

A rejected product that was imported successfully before keeps its last valid data. A new product is only added once its row is valid.

**4. Verify the products**

Open **Products** in the catalog, select the market, and check the affected products. Test a customer question in the [Playground](https://docs.yourhomie.ai/en/user-guide/assistants/playground.md) if the change affects recommendations.

The market's **Status** helps you decide what to do:

| Status | What to do |
| - | - |
| **Waiting** or **Importing** | Wait for the import to finish. |
| **Up to date** | The last import succeeded. Check products if you recently changed the feed. |
| **No import yet** | Start the first import. |
| **Error** | Open the report and follow the error message. Below the market you see the date of the product data the assistant keeps using. |
| **Check field mapping** | Map the missing required fields. |
| **Paused** | Check the market's import settings. |

Expand **Details** in the report to inspect supplemental data, product matching, documents, and notices. The results of the translations are shown in the market's **Translations** tab. For example, **Map variant options** takes you to the mapping when variants could not be grouped as expected.

> [!NOTE]
>
> **Not applied** means a newer import has already updated the market. The newer product data stays active.

> [!NOTE]
>
> **Stopped** means an automatic import was not applied because its file had less than half of the rows of the last applied import, or more than half of those rows were missing from it. The current products stay active, so a broken export cannot empty the market. If the smaller file is correct, select **Start import** to apply it.

## Unchanged files

**Unchanged** means the file has no updates to apply. Your products stay as they are. The overview shows when the file was last checked.

## Smaller files

Every update must contain the full assortment, even if you only changed a few products. After a successful import, products missing from the file are removed from the market and no longer recommended. The report counts them under **Removed**. When a product appears in the file again later, the next import adds it again.

A file that contains no rows apart from its column headers is applied as well. For a market's product file, this means the market has no products afterwards. When the market already has an applied import, though, an automatic import of such a file is **Stopped** and the products stay; **Start import** applies it. For a supplemental data file, no data from this source applies afterwards. An empty response without any content counts as an error (see below); an automatic import of a market's product file with an earlier applied import is **Stopped** instead.

## Protection against incomplete files

If a file cannot be loaded or read, the import fails. Possible causes include:

* the download was interrupted,
* the file is cut off, for example ending in the middle of a row,
* the file is damaged and cannot be read,
* the response is empty (an automatic import of a market's product file with an earlier applied import is **Stopped** instead),
* a web page arrives instead of the file, for example an error or login page.

The import then gets the status **Failed**, the market shows **Error**, and the previous state stays active; the assistant keeps showing the products and data of the last complete import. The overview names the reason. When only a supplemental data file is affected, the market is updated anyway; the affected source keeps its previous state, shows **Error**, and names the reason.

## When a file cannot be loaded

When a file cannot be loaded, the last successfully loaded state stays active until the file can be loaded again, however long that takes. The overview names the error and the date of the last successful load.

In the list of markets, the error message is followed by a line such as **The assistant uses the product data from October 6, 2026.** In the catalog list, the **Error** status shows the date of the oldest affected product data next to it, for example **Data from 10/06/26**. In this case, check the feed URL and the product export in your shop system. As soon as the file can be loaded again, the next scheduled import applies the current state.

> [!TIP]
>
> Check the source URL when a load fails. Make sure it still opens the product file without a login, then start another import. The overview shows whether a retry is already scheduled.

## Delete a market

Delete a market in its **Settings** tab with **Delete market**. The confirmation dialog names the consequences: the market is deleted with its products, translations, imports, and documents. Its products are then removed from the recommendations of every assistant using the catalog.

You cannot delete the catalog's default market while the catalog has other markets. First choose another default market in the catalog settings.

> [!WARNING]
>
> Deleting a market cannot be undone. Visitors from its countries use another matching market if one exists. Otherwise, they get the catalog's default market or, with **See no products**, no products.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.