Images Guide: UConn Knowledge Base

The Knowledge Base is a collection of information that offers technical support to the UConn community.  ITS faculty and staff can contribute by creating and editing articles within Confluence, an online workspace.

When adding or revising articles in Confluence, you can insert images to enhance the quality and clarity of your content.

If you have a Confluence account, log in with your UConn email address and password at uconn.atlassian.net.

In this article:

Screenshot Guidelines

Screenshots of websites, applications, and step by step procedures can be useful visual aids. However, they do not replace text information and should only be used to enhance the clarity of written content.

When software updates and website changes occur, screenshots are more difficult to update than plain text. To streamline future revisions and improve accessibility, it is important that the written text of an article provides clear information that can stand on its own. The use of an image should be supplementary.

Before inserting a screenshot to your article, consider:

  • Is the necessary information clearly conveyed through the text?

  • Will the inclusion of an image add value for the reader?

How to screenshot

To properly screenshot a high resolution image, use the image capturing method available for your operating system:

PC

  • Use the Snipping Tool.

  • Make sure you take your snip at a high enough zoom so that the resolution is maintained once you place your image into the article.

  • Add callouts as necessary in PowerPoint: Accessibility Guide: Call Outs in Screenshots.

Mac

  • Use the print screen function and crop the image.

  • Make sure that the section you want to crop is not too small and that it will retain a high resolution when you input the image to your article.

  • Add callouts as necessary in PowerPoint: Accessibility Guide: Call Outs in Screenshots.

Save the screenshot to your computer and open Confluence to insert it to a Knowledge Base article.

Do not paste images directly into an article from our clipboard. They must be inserted using the embedded “add image, video, or file” tool from your Confluence tool bar.

Insert and Size an Image

  1. Log in to the Knowledge Base with your UConn email address and password at uconn.atlassian.net.

  2. Click on the article you wish to add an image to.

  3. Click the Edit pencil icon in the upper righthand corner of your browser window.

  4. Place your cursor where you wish to insert the image. Screenshots should always be inserted after their corresponding instructions or information.

  5. Click the image icon in the tool bar to Add image, video, or file.

  6. From the popup window, browse and select a saved image from your files.

  7. Click Open.

Resize the image by clicking and dragging its edges. Images should be big enough that the user understands them without having to click to enlarge, but not so big that the user’s reading experience is interrupted.

When sizing the image, ensure that:

  • It does not extend past the text around it.

  • It is not too small.

  • It is not blurry.

Position an Image

  1. Left-Click on the image you wish to position.

  2. Select one of the five alignment options you would prefer:

    Positioning menu
    Left click and choose a position alignment for the image.
    1. Left Alignment: Places the image on the left side of the article.

    2. Center Alignment: Places the image in the middle of the article.

    3. Right Alignment: Places the image on the right side of the article.

    4. Wrap Left: Places the image on the left side and has the text wrapped around the right side of the image.

    5. Wrap Right: Places the image on the right side and has the text wrapped around the left side of the image.

If you wish to adjust the position of an image within an Expand Macro, left-justify the image by including it within a list first and then copying the whole section into the Expand. See the example shown below:

Add Alternate Text to enhance accessibility

Alternate text helps provide the context of images to users who use screen readers and other assistive tools by describing an image's content in words. When you add alternate text (also known as alt text) to an image, you do so under one of two conditions:

  • Add alt text to an image with explanatory text above it.

    • Use null alt text when you have adequately described the purpose of the image in the text above the image. To insert null alt text, enter double quotes ("") into the alt text dialogue box. 

  • Add alt text to an image without explanatory text above it.

    • Use descriptive alt text.

To add alt-text to an image:

  1. Left-Click the inserted image.

  2. Click Alt-Text.

  3. Write a description of the image.

  4. Press Enter.

Related Articles