Images help explain how to complete a task or what outcome the reader will achieve after following the guidelines. Images and other visual representations are more popular than text and help the reader quickly understand an otherwise complex set of steps.


Using Images in Document360

Either in the Markdown editor or the Advanced WYSIWYG editor, you can find the insert image icon.

Screenshot1-Insert_image_icon


Inserting an image in the Markdown editor

You can insert images in your documentation with the Markdown editor in four ways.

  1. Insert image from Upload/URL
  2. Insert image from file picker
  3. Insert image using Insert file
  4. Insert image by drag and drop

1. Insert image from Upload/URL

2_Screenshot-Adding_image_Insert_image_from Upload_URL

1.1 Using the upload

  1. Click the Insert image icon
  2. Select Image from Upload/URL
  3. Click the Choose file button
  4. Select the image file you want from your local storage and click Open
  5. In the Description field, type in a description for the image
  6. Click the OK button
  7. The image will be inserted into the article where the cursor is placed

The image's height and width will be undefined by default. {height="" width=""}

  1. If required, you can provide the pixel (px) dimension you want your image displayed in your documentation.

For example, {height="720" width="1280"}

  1. You can see the size of the image in the documentation in the Preview window

1.2 From URL

  1. Click the Insert image icon
  2. Select From Upload/URLURL
  3. In the Image URL field, paste the desired URL of the image
  4. In the Description field, type in a description for the image
  5. The image will be inserted into the article where the cursor is placed

The image's height and width will be undefined by default. {height="" width=""}

  1. If required, you can provide the pixel (px) dimension you want your image displayed in your documentation.

For example, {height="720" width="1280"}

  1. You can see the size of the image in the documentation in the Preview window
Tip

Adding images to the Document360 Drive and inserting them inside articles is always recommended. If you add an image from a URL and it is removed or renamed in the future, it appears broken in the Knowledge base.


2. Insert the image from the file picker

3_Screenshot-Adding_image_Insert_image_from_file_picker

  1. Click the Insert image icon
  2. Select From file picker
  3. The Drive window appears with only image format files

You can insert any number of images in one go. The multiple image selection is available only on Markdown and Advanced WYSIWYG editors.

  1. Navigate to the desired folder where the image you wish to upload is available
  2. Select the desired image and click Insert
  3. The image will be inserted into the article where the cursor is placed

The image's height and width will be undefined by default. {height="" width=""}

  1. If required, you can provide the pixel (px) dimension you want your image displayed in your documentation.

For example, {height="720" width="1280"}

  1. You can see the size of the image in the documentation in the Preview window

3. Insert an image using the Insert file

4_Screenshot-Insert_file

  1. Click on the Insert file icon
  2. The Drive window appears
  3. Navigate to the desired folder where the image you wish to upload is available
  4. Select the desired image and click Insert
  5. The image will be inserted into the article where the cursor is placed

The image's height and width will be undefined by default. {height="" width=""}

  1. If required, you can provide the pixel (px) dimension you want your image displayed in your documentation.

For example, {height="720" width="1280"}

  1. You can see the size of the image in the documentation in the Preview window

4. Insert an image by drag and drop

You can add an image to the editor by dragging it from your local system to your editor.

The images you insert in an article through drag and drop will be saved automatically in the Document360 Drive. The changes in your local file will not affect the inserted image.

Can I change the alignment of an image in Markdown?

Yes, you can change the image alignment in Markdown.
For more information, visit the article How to align the image in Markdown?


Inserting an image - Advanced WYSIWYG editor

You can insert images in your documentation with the Advanced WYSIWYG editor in the following methods.

1. Using the "Insert" menu
2. Using copy and paste or drag and drop

1. Using the "Insert" menu

  1. Navigate to the desired section in the article

  2. Click on the "Insert" menu on the right (⊞ icon)

  3. Select "Image" and a popup appears with three options

    • URL - Paste the URL of the image in the field
    • Upload image - Click to upload or drag and drop the image file from your device's local storage
    • Drive - Opens the file picker, and you can choose any image format available in your Document360 Drive
  4. Click "Insert image," and the image is added to the article

2. Using copy and paste or drag and drop

Alternatively, you can perform a copy/paste operation for the image or click, drag, and drop an image from your device's local storage inside the article.


Image formatting - Advanced WYSIWYG editor

Unlike the Markdown editor, the Advanced WYSIWYG editor offers different image formatting options. You can access the image formatting options when you click on an image you wish to edit.

5_Screenshot-Advance_WYSIWYG_Formatting

  • Align: This has three common alignment options. The Align left, Center, Align right

  • Inline left, Inline block, and Inline right: The image and text (lines that cover the height of the image) appear side by side only when the Inline display option is selected. The alignment is set as Left or Right.

If Center alignment is chosen, the image can be dragged and placed anywhere in that particular text line. However, the text wrapping will not occur on the previous and subsequent lines.

  • Image caption: You can add any text as a caption for the image. It appears at the bottom of the image


    For example, the concise description of the image, the image identifier for referencing later in the document, and more.

  • Alternative text: Also called "alt tags" and "alt descriptions." Alt text is the written copy that appears in place of an image on a webpage if the image fails to load on a user's screen.
    Type in the alternative text for the image in the field, and click on Update.
    This text helps screen-reading tools describe images to visually impaired readers and allows search engines to crawl better and rank your knowledge base

  • Insert link: Click on the link icon to add hyperlinks to your images in the article. Paste the URL, check the box below if you want the link to be opened in a new tab, and click Insert.
    Once you link your image, three new options will appear in the formatting tray (Open link, Edit link, and Unlink), which are self-explanatory

  • Style: There are three styling options available. You can either choose one, all, or a combination of styles)
    o Rounded: The image would appear as a rounded rectangle with blunt corners
    o Bordered: A light gray colored border will be added to the image
    o Shadow: The image would cast a visible drop shadow effect outside the image

  • Advanced edit - To crop, add text, and rotate.

    • Crop: Click Crop → Choose the desired crop option below the image, and crop the image. Once you're done, click Save
    • Text: Click Text and add the desired texts. Text formatting options such as Bold, Italic, Underline, Color, and Size are available. Once you're done, click Save
    • Rotate: Click Rotate and spin the image as desired with the options below the image. Once you're done, click Save
    • Filters: Adjust the image parameters such as Brightness, contrast, etc. You can also apply preset filters available.

  • Resize: To resize the image, you can use the mouse pointer to click and drag the image corners.
    You can also click on the Change size icon (Ruler icon) from the image formatting options tray. Type in the intended width and height in pixels


  • Replace: You can click on the Replace icon and use any of the three insert image methods to switch the current image for a different one

  • Delete: The Delete icon (trash symbol) removes the selected image from the article