Adding images and files to articles

For many types of documentation, images, screenshots, or sample files can add examples and detail to your documentation. The process of adding files and images to articles differs a little between the Modern Editor and the Legacy Editor.

Modern Editor: Files

Click the file (Upload File) icon. You can choose to upload a new file or add an existing file from your library.

Upload file icon

To upload a new file, drag and drop the file into this pop-up, or click anywhere in the Drop File box to browse to a file for upload.

To add an existing file from your library, click the folder icon.

Add from Library icon

This will open a pop-up where you can search for files, with the most recent files first. Click the image you'd like to upload and click the Insert File button.

Add from Library pop-up

Modern Editor: Images

To add images to your articles, edit your article and click on the Add Image icon near the upper left (or use Ctrl + P).

Add Image button

You can choose to upload a new image, add an image by URL, or add an existing image from your library. 

To upload a new image, click the icon with the arrow pointing up. You can drag and drop an image into this pop-up, or click the window to browse to an image for upload.

To add an image by URL, click the chain links, add the URL for the image, and click Insert:

Add from URL icon/pop-up

To add an existing image from your library, click the folder icon:

Add from Library icon

This will open a pop-up where you can search for files, with the most recent images first. Click the image you'd like to upload and click the Insert File button.

Sample Add from Library pop-up

Legacy Editor: Images & Files

To add images or files into your articles using our Legacy editor:

  1. Open your article in edit mode.
  2. Click on the Add File / Image button near the top.Screenshot showing the Legacy Editor with a callout to the Add File / Image button
    Legacy Editor Add File / Image button
  3. This will open the Add from Library pop-up, displaying the most recent files first.
    Screenshot showing the Add from Library pop-up that opens once Add File / Image is clicked
    Sample Add from Library pop-up in Legacy Editor
  4. To use an existing file in the library:
    1. If necessary, use the search bar at the top to search for the file you want to add.
    2. Click on the file or image to select it.
    3. Click the Insert File button to insert the file into your article.
      Add from Library search, selection, and button
    4. Be sure to Save your article after you insert the files/images you want!
  5. To add a new file to your article and the library:
    1. Click the Upload New File button in the lower left corner.
      Upload New File button in lower left
    2. This will open an explorer window; navigate to the file you wish to upload, select it, and click the Open button in the lower right.
      Sample explorer window to find and select the file you want to upload
    3. You'll see the name of the file you selected for upload in the lower left. Make sure it's what you wanted. Then click the Insert File button to insert the file into your article.
      Uploaded file name replaces the Upload File button in lower left
    4. Be sure to Save your article once you've added the files/images you wanted!