Within the platform, a product is considered “online” when it meets all required conditions for front-office visibility — meaning it is indexed, valid, and ready to be displayed to end users.

Online Eligibility Checks

Before a product can be considered online, the system verifies several conditions to ensure it is valid, visible, and complete.
The following checks apply to all products, though some are conditional depending on the selected indexation mode.

General Conditions

The product status (must be Active).
The status of its variant (must be Active).
The status of the offer attached to each variant (must be Active).
The stock level of the offer (must be greater than 0).
The presence of a valid price on the offer.
The product’s attachment to a navigation category.
The status of the navigation category (must be Active).

🚧
Important
Some of these conditions may vary depending on the selected indexation mode (for example, whether stock or price is mandatory). View all Indexation modes

Indexation Mode Conditions

Condition	With Price & Stock	With Price (Allowing No Stock)	With Offer (Allowing No Price)	Without Offers
Product status	✅ Must be Active	✅ Must be Active	✅ Must be Active	✅ Must be Active
Variant status	✅ Must be Active	✅ Must be Active	✅ Must be Active	✅ Must be Active
Offer status	✅ Must be Active	✅ Must be Active	✅ Must be Active	⚙️ Checked if offers exist (status must be Active)
Offer price	✅ Required	✅ Required	⚙️ Optional	⚙️ Optional
Offer stock	✅ Must be > 0	⚙️ Can be ≥ 0 (out of stock allowed)	⚙️Can be ≥ 0 (out of stock allowed)	⚙️ Can be ≥ 0 (out of stock allowed)
Navigation category	✅ Must be attached	✅ Must be attached	✅ Must be attached	✅ Must be attached
Navigation category status	✅ Must be Active	✅ Must be Active	✅ Must be Active	✅ Must be Active

🚧
Warning - Navigation Category Required for Product Visibility
Make sure your product is always linked to a navigation category. This is a mandatory condition in all cases.
A navigation category must be linked either to:

a classification category that contains the product

an assortment that includes the product (in which case the navigation must be of type custom)

Click here to learn more about linking navigation categories to products : Navigation categories

Online Status in the Back Office

In the back office, you can easily check whether a product is online.
This information is available through the Online Status indicator, which appears in two places:

In the product list, where each product displays its current online status.
- Go to Catalog -> Product list
In the product details page, where the same indicator confirms whether the product is online or offline.

👉
Tip:
If a product is unexpectedly marked as offline, check its offers, navigation category, and stock or price data — one of these conditions might not be met.

Diagnosing Online Status via API

Three dedicated API endpoints allow you to programmatically check the search indexation status of a product, a variant, or an offer. Each endpoint returns whether the entity is online or offline, along with the precise offline reasons when applicable.

Search Status Endpoints

Entity	Method	Path	OperationId
Product	`GET`	`/v1/products/{productId}/search-status`	`ADM-PRODUCT-500`
Product variant	`GET`	`/v1/product-variants/{productVariantId}/search-status`	`ADM-PRODUCT-VARIANT-500`
Offer	`GET`	`/v1/offer-inventories/{offerInventoryId}/search-status`	`ADM-OFFER-500`

All endpoints require dj-client: OPERATOR and dj-api-key headers.

Query Parameters

Parameter	Type	Required	Description
`idType`	string	No	Type of identifier used in the path. Enum: `DJUST_ID` (default), `EXTERNAL_ID`.

Response — 200 OK

{
  "id": "prod-001",
  "externalId": "EXT-PROD-001",
  "online": false,
  "indexationMode": "WITH_PRICE_AND_STOCK",
  "offlineReasons": [
    "OFFER_INACTIVE",
    "NO_STOCK"
  ]
}

Field	Description
`id`	DJUST internal identifier
`externalId`	External identifier (if set)
`online`	`true` if the entity is currently indexed and visible online
`indexationMode`	The indexation mode used during the last indexation
`offlineReasons`	Array of reason codes explaining why the entity is offline. Empty when `online` is `true`.

✅
Tip: Use these endpoints to build self-service diagnostic tools or monitoring dashboards, eliminating the need to open a support ticket to understand why an entity is offline.

⚠️
Warning: The offline reasons returned depend on the indexation mode that was active during the last indexation. If the indexation mode has changed since then, the reasons may not reflect the current configuration until the next indexation run.