Documentation Center

Adding an image to a topic

Including images in published content is an essential part of authoring. The basic action is simple, whereas all the related technical aspects (resolution, format, size, etc.) can be covered by customization and plugins addition.

Before you begin

This task requires that:
  • You opened a topic in your favorite XML editor.
  • An image is stored on your file system in the PNG format.

About this task

In your topic, you can insert only images that are stored in the Repository. Therefore, you first need to add your image to your Repository.

Procedure

  1. In your XML editor, select SDL Tridion Docs > Browse Repository.
  2. Navigate to the Repository folder where you want to store the image. Like for any type of object, images are stored in subdirectories that contain only images.
  3. In your file system, find the image you want to use, drag and drop it in the Repository folder, then close the Browse window.
  4. In your topic, select the location where you want to insert the image, then Insert > Image from the editor's top menu bar.
  5. Select Browse.
  6. Navigate to the folder where you have dropped your image, select the image then OK.
  7. Back in the insertion dialog, for the attribute Text wrapping, select the value break, then OK.
    The break value means that the system will introduce a new empty line of text where the image will be inserted, instead of inserting the image in the middle of a text line.

Results

Your image is inserted in your topic. There can be more to it, but the basic actions are here. The three main advanced aspects related to images are:
  • How to manage the resolution type of the image. An image can be stored in the Repository in several resolutions, and each is used in specific cases. Out of the box, the default resolution that is chosen when you insert the image is Low. It may be different when you try it: this is set in Content Manager Default Settings by your administrator.
  • How to use the attributes of the image, that you can set in the insertion dialog. We have mentioned only Text wrapping; you can find information about the others in Tridion Docs documentation.
  • In your topic, which tags you should use for the insertion, and inside which tags you should insert the image. This is both DITA knowledge and specific company standards, and is not part of Tridion Docs documentation.