Skip to content

Create and edit content items

Create content items

  1. Start creating a new content item in one of the following ways:

    • In the left panel, go to Content -> Content structure. Then select a parent content item and click Create content.

      The new content item becomes a child of the content item that you originally selected.

    • In the upper-right corner of the My dashboard screen, click Create content. Then choose a location for the new item in Content Browser and click Create.


    An alternative way of creating content items is to drag one or more files onto the Sub-items tab when viewing any content item in a Content Tree.

  2. In a slide-out pane, make initial choices in the following fields, and click Create:

    • Select a language - from a drop-down list, select the base language for the content item.
    • Select a content type - use this field to narrow down the list of choices displayed below. Then select a content type to serve as a template for the content item.


    If you're using Ibexa Experience or Ibexa Commerce, the options include forms and pages. You then build forms and create pages by using their respective specialist tools.

  3. Fill in the Fields of the content item.

  4. Click Preview to see how the content item could look to an end-user. !!! tip

    A content item can look different on different [SiteAccesses](
    You can select a SiteAccess to preview by using a drop-down in the preview screen.
  5. To discard your changes and close the window, click Delete draft.

  6. To save your changes:

    • Click Save to continue editing.
    • Click Save and close to close the window.
  7. To send your changes to another editor for review, click Send to review.

  8. When the content item is ready for publication:

    • Click Publish to publish it immediately.
    • Click Publish later to set a specific publication date.

    For more information, see Publish content.

Versioning and autosave

Whenever you edit a content item, a new version is created in the repository.

To help you preserve your work, Ibexa DXP saves drafts of content items automatically. For more information, see Autosave.

Upload multiple content items

When you view the content item details in the Content Tree, you can upload files such as images, videos, PDF documents, and so on. This way you can add multiple sub-items without editing the original content item. To do it, on the content item details screen, in the Sub-items tab, click Upload and choose all items that you want to upload. When a file is uploaded with multi-file upload, it is automatically stored in a Field of the content item.


The content type for the uploaded files is selected automatically by the system.

Multi-file upload

Edit new or existing content items

Each content item is based on a content type. The content type defines what Fields you have to fill in when creating a new item. It may also determine the layout or style in which this item is displayed.

Fields marked with an asterisk (*) are required. You can't save the content item without filling them in.

Some Fields, such as Relation Fields (which link two content items) or Image Fields require you to select a different content item to link to. A Location Field is a point on the map. You can type the place name, enter its coordinates, or select it on the map.


When you create or edit a content item that contains an Image or an Image asset Field, you can perform basic image editing functions by using an Image Editor.

Edit Rich Text Fields

Rich Text Fields are filled in using a special Online Editor. Its options appear when you click the Field box.

Online Editor menu

To add a new element to the Field, choose one of the available elements:

  • Heading
  • Paragraph
  • Unordered list
  • Ordered list
  • Image
  • Embed
  • Table
  • YouTube
  • Twitter
  • Facebook

Available Rich Text block elements

Each of these elements can have its own settings, such as text formatting. The option bar also lets you reorder or remove any elements in the Rich Text Field.

Edit embedded content items

You can edit embedded content items without leaving current window.

To do it, first insert selected content item in the Rich Text Field. Then, click the three dots icon on the right side and click Edit.

Edit embedded content item

If the content item has more than one translation available, you need to select the language.

Edit embedded content item - select language

This action opens a new browser tab with an editing screen of the selected content item. When you finish editing the item, click Publish. To see implemented changes refresh the browser page.

This option is also available when you want to set up a relation with another content item.

Edit embedded content item - set up a relation

Distraction free mode

While editing Rich Text Fields, you can switch to distraction free mode.

Distraction free mode expands the workspace to full screen and shows only editor toolbar. It's helpful when you need to work with longer texts that take more space and when you want to focus your attention on editing text.

Distraction free mode

To access distraction free mode, click Distraction free mode on the right side above the workspace.

Access distraction free mode

To exit distraction free mode, click Exit distraction free mode or press Esc on the keyboard.

Exit distraction mode


For longer texts, insert an anchor linking a fragment of text with another fragment or section to quickly jump through sections of an article. Create an anchor by clicking in the area to link to and selecting the anchor icon from the editor menu. In the modal window, provide the name for the anchor. Scroll to the fragment where you want to insert the link, and select the text to appear as a link. In the modal window, click the Link button. This opens the window to create the link. In the Link to box, enter the anchor name. Click Save.


In image options you can select an image variation. Variations can include different sizing options and other filters that are applied to images. Available image variations must be configured at the developer level. SeeĀ Images for a technical guide on how to do this.


Table options in online editor

In table options you can define the first row and/or column as headers, add or delete rows and columns in any part of the table, as well as merge and split cells.

Custom elements

Your installation can also have custom elements available in the Rich Text field. Contact your website administrator about the details of using them.

SeenThis! streaming


This custom tag is in an opt-in bundle, to use it, install ibexa/connector-seenthis bundle first.

Use SeenThis! tag to enable displaying of video with maximum quality regardless of connection and server integration.

For more information, see SeenThis! page block documentation.

Text formatting

When you select a section of text, you get access to text formatting options such as bold or underline. Here you can also add a link to the text. You can link to an external website, or to another content item.

Add taxonomy entries

To keep your content organized and easy to find, you can add taxonomy entries to a content item while creating or editing it. For this feature to work as described, the content type must have a Metadata section, with a Taxonomy Entry field in it.

  1. Switch to the Meta tab.
  2. Click the Select path button.
  3. In the pop-up window, select the tags you want to add.

Selecting Taxonomy entries

For more information, see Assign tag to content from taxonomy tree.