Virginia Tech® home

Image component

The Image component is used to place images on a page.

The Image configuration dialog contains the following options:

  • Image asset - drop zone for drag and drop of images from the Assets sidebar
    • NOTE: Do not use the browse function to upload assets directly to the component.
  • Component Title - text input field that does not display for this component but useful for giving the component a title for keeping track of what it is used for on the page
  • CSS Class - text input field for custom CSS and/or utility classes
  • Link to - text input field to link a page to the image; link can be a /content or https:// link type
  • Description - textare input field for a description of the image; this field does not display in a page
  • Caption - textare input field for an image caption
Image Component Title and Options configuration dialog
Image Component Title and Options configuration dialog

The Accessibility configuration dialog contains the following options:

  • Alternative text - text input field for accessible alternative text descriptions of the image
    • NOTE: Alternative text is required for non-decorative images and must be a brief description of the image contents. Avoid using text in images or images that are complex diagrams as they will require long descriptions if their content is not explained by other text on the page.
  • Image is decorative - checkbox for images that do not contain information relative to the page and are purely decorative, e.g., a decorative stencil image being used to separate sections of a page
  • Fill Alternative Text from Assets - button used to fill the alternative text field from the image properties
Image Component Accessibility configuration dialog
Image Component Accessibility configuration dialog

The Formatting configuration dialog contains the following options:

  • Image Size - select pulldown to set the image size is used; Adaptive, Thumbnail, Small, Medium 240, Medium, Large (original size)
    • NOTE: Using a size other than Adaptive will break page responsiveness. If an image needs to appear at a specific size, you can select a pre-determined size from the pull-down menu. The sizes are:
      • Thumbnail: 52x52
      • Small: 185 pixels wide
      • Medium 240: An image that's 240 pixels wide
      • Medium: 490 pixels wide
      • Large (original size): The image at the size it was uploaded.
  • Alignment - select pulldown to set the image alignment relative to the page; Center, Left, or Right
Image Component Formatting configuration dialog
Image Component Formatting configuration dialog

Editing an image

Once in place on the page, click the image to see the component toolbar.

Click the pencil icon to crop, rotate, or flip the image.

Note: Any changes made to the image will apply to this page only. Edits made on a page will not affect the original image in the Asset library. 

Once edits have been made (if any), click the check mark to save changes. 

Image editing on the page
Click the pencil icon to edit an image on a page. You can crop, rotate, or flip an image.

This component inserts an image onto the page. It affords image editing as well as the configuration of certain properties and styles. Images can be sourced from Ensemble's asset library or from the user's computer directly.


  • Basic image editing
  • Accessibility enforcement
  • The image can be a link
  • Various size and positioning configuration options
  • Automatic image quality adjustments with the adaptive image option
  • Custom text description and caption

Image editing

The image may be edited in-line after choosing it from the dialog properties and clicking the pencil icon.

Edit Options

  1. Crop
  2. Rotate - Clockwise rotation
  3. Undo - Undo the most recent edit
  4. Redo - Redo the most recent edit
  5. Enable full screen - Launches a full screen editor with more options
    • Map functions not working at present ( 08/2020 AEM )
    • Reset Zoom - If the user has zoomed into the image, reset to the default view
  6. Zoom - Opens a slider control to zoom in or out with
  7. X - Cancel edits
  8. Checkmark - Confirm edits

Dialog Properties

Title and Options

  1. Image asset - Browse for an image file on your computer or drag one over from the digital asset library
  2. Component Title - Title of Component
  3. CSS Class - CSS class to be applied to the component
  4. Link to - Renders the image as a link to another page
  5. Description - A short paragraph of text describing the image
  6. Caption - A short sentence that will serve as the caption of the image


  1. Alternative Text - a short sentence providing a description of the contents of the image. This will be used by screen reader software to assist visually impaired individuals
  2. Image is decorative - if an image serves no meaningful purpose (i.e. is an icon or symbol, or does not provide any real content to the user) then this option will hide it from screen reader software
  3. Fill Alternative Text from Assets - This option will fill the Alternative Text field with the alt text or title from the asset in the asset library


  1. Image Size - Choose the size of the image
    • Adaptive - Automatic image quality adjustments based on screen width
    • Thumbnail - The smallest image size
    • Small - Forces the width to be a smaller size
    • Medium 240 - Forces the width to be 240 pixels
    • Medium - Forces the width to be a medium size
    • Large - The image loads in its original size
  2. Alignment - the horizontal positioning of the image
    • Default - For use with the adaptive image format. The adaptive image cannot be aligned
    • Center
    • Left
    • Right

CSS Classes

  • adaptiveimage
  • caption
  • center-block
  • clearfix
  • image
  • img240
  • img490
  • parbase
  • pull-left
  • pull-right
  • section
  • vt-image
  • vt-image-caption
  • vt-image-desc
  • vt_adaptive_img
  • vt_img
  • vt_img_center
  • vt_img_left
  • vt_img_right
  • vt_large_img
  • vt_medium_img
  • vt_small_img
  • vt_thumb_img