Adding Rich Content (JSON)

Table of Content

Rich content is a marketing tool that allows you to add rich media elements such as images and videos to your PDP descriptions.

Rich content boosts the interest of potential customers in your products. You can also use it to highlight certain features or advantages of a product.

For your convenience, we have prepared a JSON template with different widgets. Widgets contain parameters responsible for presenting rich content and captions. For example, an image is full width with text below it. Or images are staggered, with text on the side. The display of rich content is customizable for both the website and the mobile version.

See how the description on the PDP changes if you add rich content:

JSON template to fill in

Rich content documentation

Advantages of uploading Rich content in JSON format:

  • using Ozon styles: if you fill in the template correctly, the product description will be displayed correctly on devices of different types;
  • secure, fast content uploading without the use of iframes.

Filling in JSON templates #

  1. Open a template.

  2. Select the Песочница (Sandbox) tab. You will see a layout with photos and captions for photos and videos. All the changes you make in the editor will be displayed on the layout.

  3. Click Открыть редактор (Open editor).

  4. Make the necessary changes in the editor: add direct links to images, insert text, and specify the photo size. To add a video, enter a direct link or YouTube video ID. Copy and add appropriate widgets. Remove the widgets you don’t use from the editor.

    We have added different widgets to the editor. For example, to add an image with text below the photo, fill in the following parameters:

    • scr: a direct link to the image to be displayed on the website;
    • srcMobile: a direct link to the image to be displayed in the mobile version of the website or in the app;
    • width: the width of the image on the website;
    • height: the height of the image on the website;
    • widthMobile: the width of the image in the mobile version;
    • heightMobile: the height of the image in the mobile version;
    • title: caption for the image—title;
    • content: caption for the image—body text.
Make sure that for each open bracket, a corresponding closed one is present.

An example of a filled in widget:

 "widgetName": "raShowcase",
 "type": "billboard",
 "blocks": [
         "img": {
             "src": "",
             "srcMobile": "",
             "width": 1280,
             "height": 853,
             "widthMobile": 640,
             "heightMobile": 640
         "title": "Great for beginners",
         "text": {
             "content": [
                 "A classical guitar doesn't sound as loud as a steel-string acoustic, but the softer nylon strings make it perfect for beginners."

If there are errors in the code, you’ll see Invalid JSON in the lower right corner.

  1. Add Rich content using any method you like:

Adding rich content via API #

To send queries via Ozon Seller API, you need a user ID and an API key. To do this:

  1. In your profile, go to SettingsAPI keys.

  2. The user ID is Client Id.

  3. To create an API key, in the API key section, select the Products token type, enter the key name, and click Generate key.

  4. Use the POST /v2/product/import query to add rich content.

Using the rich content documentation #

You can learn more about different widgets in the Rich content documentation. For example, you can find out how many blocks you can add to a widget of the “chess” type.

  1. Go to the Rich content documentation.

  2. Select the components/v0_3/showcase/typesWidgetShowCaseChess widget.

  3. In the Properties section, all the parameters are listed that you should specify for the selected widget. The blocks parameter adds an image and a caption for it. The minimum number of blocks in a “chess” type widget is 2. The maximum number of blocks is six in a single widget.