All articles

Product feed guide for your developer (custom website)

If your store runs on your own website and not on a platform like Salla or Odoo, nashir can still read your products. Your developer publishes one file that lists your products at a web address, and you paste that address into nashir. nashir reads it, imports your products, and then reads it again every 6 hours to keep prices and availability up to date.

Give this page to your developer. It has everything they need.

Connect the feed here:

/stores

What the feed is

A product feed is a file your website generates that lists every product you sell, one entry per product. nashir uses the same format as the Google Merchant Center product feed, so if you already have a feed for Google Shopping or for Meta's catalog, the same address works here.

  • The address must start with https:// and be reachable by anyone on the internet. No password, no login.
  • The file can be XML (RSS 2.0 or Atom) or text (tab-separated or comma-separated, with a header row).
  • The file must contain all your products every time, not only the ones that changed.
  • Every price must include an ISO 4217 currency code, for example 35000 IQD. A product whose price has no currency code is skipped.
  • Maximum size: 25 MB and 50,000 rows. A .gz compressed file is accepted.
  • Text encoding: UTF-8.

Sample files

Start from a sample and replace the products with yours:

The fields

In XML, each field is an element inside the product's <item>, written with the g: prefix, for example <g:price>35000 IQD</g:price>. The file's root element declares the prefix: <rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">. In a text file, each field is a column, and the first line holds the column names.

FieldRequiredWhat to put in itExample
idYesYour own unique code for the product. Never change it and never reuse it for another product.SKU-1001
titleYesThe product name.Leather wallet
priceYesThe number, a space, then the 3-letter ISO 4217 currency code. Without the code the product is skipped.35000 IQD
descriptionRecommendedA plain-text description.Handmade brown leather wallet.
linkRecommendedThe product's page on your website. Your assistant sends it to customers who want to buy.https://www.example.com/products/leather-wallet
image_linkRecommendedThe main photo (JPEG or PNG, at an https address).https://www.example.com/images/wallet-1.jpg
additional_image_linkOptionalMore photos, up to 10. In XML repeat the element. In a text file separate the addresses with commas.https://www.example.com/images/wallet-2.jpg
sale_priceOptionalA discounted price, same format as price. It must be lower than price.28000 IQD
sale_price_effective_dateOptionalWhen the discount applies: start and end, separated by /.2026-12-01T00:00+0300/2026-12-10T23:59+0300
availabilityRecommendedOne of in_stock, out_of_stock, preorder, backorder.in_stock
product_typeOptionalYour own category. Use > between levels.Accessories > Wallets
brandOptionalThe brand name.Example
sizeOptionalThe size of this option.M
colorOptionalThe colour of this option.Blue
item_group_idFor sizes and coloursThe same value on every size or colour of one product. See below.SKU-2001

Any other field from Google's specification can stay in the file. nashir ignores what it does not use.

Prices

Every price needs an ISO 4217 currency code. A product whose price has no currency code is skipped: it is not imported, and your assistant does not know about it. nashir never guesses a currency. A sale_price with no currency code is ignored, and the product is imported at its normal price.

  • Write the price as the customer pays it, with the currency code after the number: 35000 IQD, 49.99 USD, 120 SAR.
  • Use the ISO 4217 code, 3 letters (IQD, SAR, AED, EGP, USD…), not a symbol like $ or د.ع, and not a name like dinar.
  • Use a dot for decimals: 49.99, not 49,99.
  • 35000 alone is skipped. 35000 IQD is imported.
  • The check on the Stores page lists every skipped row with its row number, so you can fix it before you connect. After you connect, the store's card shows how many rows were skipped.

Sizes and colours

If one product comes in several sizes or colours, write one entry for each, give each its own id, and put the same item_group_id on all of them. nashir shows them to the customer as one product with options.

Example: a t-shirt in M and L is two entries with the ids SKU-2001-M and SKU-2001-L, and both have item_group_id set to SKU-2001. Each entry can have its own price and its own availability.

Do not put item_group_id on a product that has no options.

Two languages

If your store has product names in Arabic and English, publish two feeds: one in your main language and one in English, with the same id for the same product in both. In nashir, open My store has product names in two languages and paste the English feed address. nashir takes the English names from the second feed. Prices and availability always come from the main feed.

How nashir keeps your products up to date

  • nashir reads the feed again every 6 hours. You can also press Re-run import on the Stores page at any time.
  • A new product in the feed is added. A changed price or availability is updated.
  • Your assistant knows what is in stock. When a customer asks about a product marked out_of_stock, it says the product is not available now and suggests available products from the same category (product_type), each with its own price and link. When the entries of one product differ, it tells the customer which options are available. A product with no availability value is not described as available or unavailable.
  • A product that is no longer in the feed is archived: your assistant stops offering it. It is not deleted, and it comes back if it returns to the feed.
  • If the feed cannot be reached, is empty, or cannot be read, nothing changes: your products stay exactly as they were after the last good read. After 3 failed reads in a row, the Stores page shows a warning and the team owner gets an email.
  • If your web server sends an ETag or Last-Modified header, nashir uses it to skip the download when nothing changed. This is optional.

Check before you connect

  1. Open the feed address in a browser. You should see the file, not a web page and not a login screen.
  2. On the Stores page, paste the address and press Check feed. nashir shows how many products it found, the first few as it read them, and every row with a problem. Nothing is imported at this step.
  3. When the result looks right, press Connect and import.

Common problems

  • "The feed address answered with an error": the address returns an error page. Open it in a browser and check with your developer.
  • "did not return a product feed": the address returns a web page instead of the file. The address must return the XML or text file directly.
  • "the price has no currency code": add the 3-letter code after the number, for example 35000 IQD.
  • "the same id appears twice": two products share one id. Each id must be unique.
  • Some products were not imported because of your plan: your plan includes a set number of products. See the plans page to import more.

/billing

For Salla and Odoo stores, see the store connection guide:

/help/connect-your-store

Product feed guide for your developer (custom website) — nashir