Inserting an image in a topic

Last Updated : Apr 09, 2024 |

About this task

If you are referencing an image that has multiple versions, you can select the version of the image that you want to use in the publication. If a topic referencing an image is used in different versions of a publication, you can select different versions of the image to use in the different versions of the publication, even if the version of the topic is the same. But if you are referencing the same image multiple times in the same publication, you cannot use different versions of it.

Before you begin

Import the image into the Tridion Docs repository. See Importing images.

Procedure

  1. Check out the topic in which you want to insert the image.
  2. Optional To add a title for the image:
    1. Place the cursor where you want to insert the image in the topic and insert a figure (fig) element.
    2. Insert a title element within the fig element, and type a title for the image.
  3. Place the cursor where you want to insert the image in the topic and insert an image element.
  4. In the Insert image window, browse and select the image.
  5. Preview the image to see if you selected the correct image.
  6. To add a title to the image, type a text in the Figure title field.

    The editor wraps the image element within the figure element.

  7. For larger images, such as block diagrams set the placement attribute to break.

    The placement attribute determines whether the image can break to a new page when appropriate or stay with the text around it. If you leave the placement attribute at the default of inline, it can cause some strange page breaks in your PDF output and it will prevent the image from being automatically scaled to fit in the width of the text box. For images that are too long, use the height attribute to constrain the height.

  8. In the Attributes dialog box, set one of the following attributes to control the size of the image in the output:

    • width: If the image is too wide, set the width in inches. Enter the number followed by in to indicate inches.

      When you set the width, the height is proportionally scaled.

    • height: If the image is too long, set the height in inches. Enter the number followed by in to indicate inches.

      When you set the height, the width is proportionally scaled. The maximum height you can use is 8.75in. If you are using an image and not the fig element, or you are using fig but not including a title, you can set slightly higher than 8.75in.

    • scale: To scale the image to a specific percentage. Do not enter the percentage character; it is assumed.

  9. If you need to use the image for an end user output, within the image element, add an alt element, and type a description of the image to make the image accessible for users using screen readers or text-only readers.

    Do not use the Alternative text (alt) attribute in the Image element.

  10. Click Insert.

    If an image has multiple versions, and you want to select an older version, you cannot do that when you insert the image. But after you insert the image, you can locate where the image is being referenced on the Content tab in Publication Manager and select the version.

    The image with selected attributes gets added in the topic.