Skip to content

Hello World

This tutorial allows you to chain multiple inseri blocks, with the specific example focusing on:

  • Adding predefined images in dropdown menu
  • Allowing the end user to select the images to display

For the final product, please click here.

Step 0: Initialize your inseri instance

Open up inseri Playground or your WordPress instance with inseri-core plugin installed.

Beware that changes done in the playground will not be saved.

Step 1: Create a new post

Add a new post with the title "Image Selection", as presented in the figure below.

Adding a new post in WordPress

Step 1: Adding a new post in WordPress: (i) hover on mouse pointer over New and next, (ii) click on Post (or click directly on New)

Step 2: Add the Text Editor block

Adding a new block in WordPress

Step 2: Adding a new block in WordPress by typing the forward-slash "/" and the block name (see the left side) or using the "+" icon and searching the block name (see the right side).
  1. Add the Text Editor block by using the slash command, i.e., typing "/text editor" in the area "Type / to choose a block". Alternatively, you can use the Block inserter, i.e., the "+" icon below the title, and type "text editor" in the Search area.
  2. Choose the format "JSON".
  3. Next, rename your Text Editor block. For this, open the settings sidebar on the right and enter simply "textEditor" under "BLOCK NAME".

Edit the block name

Step 2: Edit the block name: (i) open the settings sidebar, (ii) enter the desired name under "BLOCK NAME"


You can hide the text editor block if you want (the setting is below the "BLOCK NAME, and is called "Show block" that by default is enabled).

Step 3: Add dropdown and image information to the text editor

  1. Now, copy the following snippet into the text editor. This will add two options ("UZH Acronym" and "UZH Logos") to the dropdown (see the "label" values below). Moreover the "value" values will be used to fetch the image and display it in Step 5.
    { "label": "UZH Acronym", "value": "" },
    { "label": "UZH Logos", "value": "" }

Step 4: Add the Dropdown block

  1. Add the "Dropdown" block (like in Step 2.1.).
  2. Select the block source with the name "textEditor - content".
  3. Give the Dropdown block a simple name "dropdown" (like in Step 2.3.).
  4. Choose a value (e.g., "UZH Logos").


You can edit the text "Choose an item" by using the "LABEL" area below the "BLOCK NAME".

Step 5: Add the Image Box block

  1. Add the "Image Box" block (like in Step 2.1.).
  2. Select the block source with the name "dropdown - chosen value".


    If you cannot see the block source, make sure that you did Step 4.4.

  3. Give the Image Box block the name (like in Step 2.3.).

Step 6: Data Flow

The Data Flow provides an overview of the inseri blocks and the dependency between them. The data flow corresponding to this tutorial should be similar to the one below.

Data Flow

Step 6: Data Flow: (i) select "inseri" close to the Settings icon, (ii) select a block name in the "inseri Blocks" section or a node in the "Data Flow Chart" section.

Step 7: Save and publish

For the final step, you should save your post and publish it (The "Save draft" and "Publish" buttons are in the top right close to the Settings icon).

Once published, you can view the post and you will see the text editor with the snippet (step 3) and a dropdown (step 4), where the corresponding image will load after the selection.


The Data Flow Chart (see Step 6) provides a nice overview. You can see it also at the bottom of the Hello World.