Setting Up an Instagram Shop for 1C-Bitrix
Instagram Shopping allows tagging products directly on photos and in Stories — a user taps a tag and lands on a product card within the app. To use this feature you need a business Instagram account connected to a Facebook (Meta) Business Manager catalog, and a correctly configured product feed from Bitrix.
Integration Architecture
Instagram does not accept products directly — the catalog is managed through Facebook Commerce Manager (business.facebook.com/commerce). Bitrix exports a product feed in XML format (analogous to Google Merchant Center) or CSV to a public URL; Facebook periodically fetches it and updates the catalog.
Data flow: b_iblock_element + b_catalog_price → XML feed on the server → Facebook Catalog → Instagram Shopping.
Preparing the Feed in Bitrix
The bitrix:sale.export.google.merch component generates a feed in Google Merchant format, which Facebook accepts without any structural changes. Critical component parameters:
-
IBLOCK_ID— the trading catalog info block -
PRICE_TYPE_ID— price type (usuallyCATALOG_GROUP_ID = 1) -
USE_SALE_PRICE— whether to include discounted prices fromb_catalog_discount -
IMAGE_PROPERTY— the property storing the image URL (if not the main photo)
The feed is served at a fixed URL such as https://site.com/fb-feed/. The page is created through the site menu with a template that excludes the header and footer — only the XML output.
Required Fields for Instagram Shopping
Facebook strictly validates fields when loading the catalog. Without them, the product is rejected:
| Feed field | Source in Bitrix | Requirement |
|---|---|---|
id |
Info block element ID |
unique, never changes |
title |
NAME |
up to 150 characters |
description |
DETAIL_TEXT property |
at least 5 words |
availability |
stock from b_catalog_store_product |
in stock / out of stock |
condition |
property or fixed new |
new / refurbished / used |
price |
b_catalog_price |
format "100.00 RUB" |
link |
DETAIL_PAGE_URL | https, working link |
image_link |
main photo | min 500×500, JPG/PNG |
Special attention is required for google_product_category. Instagram requires a value from the Google taxonomy (numeric code). A mapping between info block sections and Google categories is configured via custom fields on sections in b_iblock_section.
Connecting to Business Manager
In Facebook Business Manager, an "E-commerce" type catalog is created with a Data Feed source pointing to the Bitrix feed URL and an update schedule — at minimum once per day, recommended every 4 hours. After the first load, Facebook shows a list of errors per product — this is the primary diagnostic tool.
For Instagram Shopping, the Instagram account is connected in the catalog settings under "Sales Channels". After moderation (typically 1–3 business days), the ability to tag products on posts becomes available in the Instagram app.
Common Setup Errors
Domain not verified — Facebook requires proof of domain ownership via a DNS record or meta tag. Added in Business Manager settings → Brand Safety → Domains.
Price mismatch — if the website shows a discounted price but the feed contains the base price, Facebook may reject the product. Either pass both fields (price and sale_price), or synchronize the discount logic.
Images with watermarks — Instagram automatically rejects images with text covering more than 20% of the image area.
What Is Included in the Setup
- Configuring the export component and verifying feed correctness
- Registering and setting up the catalog in Facebook Business Manager
- Mapping Bitrix categories to the Google taxonomy
- Domain verification and Instagram account connection
- Resolving errors from the initial catalog load
- Configuring the feed auto-update schedule