Skip to content

Advanced Image

Add images with powerful styling and customization options.

The Advanced Image block goes well beyond the standard image block. It adds aspect-ratio control, lightbox support, links, captions, flip effects and hover animations — all in one place.

Advanced Image block in the editor

When to use it

  • For feature images that need precise sizing and aspect ratios.
  • To open an image in a lightbox on click.
  • To add a styled caption with custom position and visibility.
  • For interactive images with flip or hover animations.
  • To wrap an image in a link (with new-tab / nofollow options).

How to add it

  1. Click the + block inserter in the editor.
  2. Search for Advanced Image and select it.
  3. Click Select Image to choose or upload media, then configure the panels.

Adding Advanced Image

Settings

Select the block and open the inspector on the right. Settings are split across two tabs: General (specific to this block) and Advanced (shared by all Styble blocks). The Image and Caption panels also have Settings and Style sub-tabs.

General tab

Image

The core image settings:

ControlWhat it does
Select ImageChoose or replace the image from the media library.
Flipping ImageToggle a two-sided flip effect.
Flip OnTrigger for the flip (e.g. hover).
Flip DurationLength of the flip animation.
Aspect RatioConstrain the image to a fixed ratio.
Max WidthLimit the image width.
Width / HeightExplicit dimensions.
Image ResolutionPick the registered image size to serve.
Open Image in LightboxToggle lightbox on click.
Lightbox Click ActionWhat clicking does when lightbox is on.
Icon Position / Icon VisibilityPlacement and visibility of the lightbox icon.
Add LinkWrap the image in a URL (with new-tab / nofollow).
AlignmentAlign the image within its container.
Alternative TextAlt text for accessibility and SEO.

Caption

Add and style a caption beneath or over the image:

ControlWhat it does
Image Caption SourceWhere the caption text comes from.
PositionWhere the caption sits relative to the image.
Caption VisibilityAlways visible or on hover.
Caption PositionFine-grained placement (overlay).
Caption WidthWidth of the caption box.

Hover Effect

Add motion when the user hovers the image:

ControlWhat it does
Image AnimationThe hover animation applied to the image.
Caption Hover EffectThe hover animation applied to the caption.
EasingAnimation easing curve.
Animation DurationHow long the animation runs.
Animation DelayDelay before the animation starts.

Advanced tab

The Advanced tab is shared by every Styble block (Section Preferences, Transform, Scrolling Effects, Motion Effects, Position, Masking, Cursor, Responsive, Attribute, Custom CSS). See Advanced settings for the full reference.

Nesting & relationships

  • Advanced Image can be placed anywhere, including inside a Container or Column.
  • Supports wide and full width alignment from the block toolbar.

Tips & common patterns

  • Set a fixed Aspect Ratio across a row of images for a clean, uniform grid.
  • Combine Open Image in Lightbox with a caption for gallery-style presentations.
  • Use Caption Visibility: on hover with a Caption Hover Effect for interactive cards.
  • Always fill Alternative Text for accessibility and SEO.
  • Define shadows, borders and overlay colors in Global Settings for consistency.

Released under the GPL-2.0-or-later License.