Tool Panel

Image Widget

Image Widget

The Image Widget displays a single image on the page. It supports configurable aspect ratios and optional heading and description text.

Common Tasks

Adding the Widget to a Page

  1. Navigate to the page in the Contensive page editor.
  2. Click the widget tool to open the widget panel.
  3. Find the Image Widget in the Design Blocks category.
  4. Drag the widget onto the page at the desired location.
  5. The widget will appear ready for you to upload an image.

Editing Widget Content

  1. Click the edit icon on the Image Widget.
  2. Upload or select an image using the Image Filename field.
  3. Set the Image Aspect Ratio to control how the image is cropped and displayed.
  4. Optionally add a Headline or Description to display with the image.

Changing the Image

  1. Click the edit icon on the widget.
  2. Click the Image Filename field and select or upload a new image.
  3. Adjust the Image Aspect Ratio if needed for the new image.

Styling the Widget

  • Open the advanced editor to access the Styles tab.
  • Set padding (top, right, bottom, left) to control spacing around the image.
  • Choose a Theme Style to apply a predefined look.
  • Set a Background Image on the Background tab.
  • Enable As Full Bleed for edge-to-edge rendering.
  • Set a specific Height if needed.

Removing the Widget

  • Click the edit icon on the widget and open the advanced editor.
  • Set the Active field to "No" on the Control Info tab to hide it, or delete the record to remove it permanently.

Edit Dialog Fields

Field Description
Image Filename The image file to display
Image Aspect Ratio Select the aspect ratio for the image (default: 3)
Headline Optional heading text displayed with the image
Description Optional text displayed below the image (HTML)

Advanced Edit Fields

Field Tab Description
Name Control Info Internal name for this widget
Pad Top Styles Add top padding to the widget
Pad Right Styles Add right padding to the widget
Pad Bottom Styles Add bottom padding to the widget
Pad Left Styles Add left padding to the widget
As Full Bleed Styles Include margins for content
Height Styles Set a specific height with units
Theme Style Styles Select a layout wrapper class from Design Block Themes
Background Image Background Set a background image for the widget