Image Tooltip 3.0 is a Joomla content plugin for Joomla 4, Joomla 5, and Joomla 6. Install pkg_image_tooltip_3.0.zip through System > Install > Extensions. The package installs both the content plugin and the Editor - Image Tooltip button.

After installation, confirm both plugins are enabled under System > Manage > Plugins (search for Image Tooltip). Clear Joomla, template, CDN, and browser caches after installing or updating.

Use the Image Tooltip button in the article editor toolbar to insert a shortcode without typing attributes by hand. Choose image or text trigger, theme, placement, float, widths, title, body copy, and optional link, then click Insert shortcode.

Add a tooltip anywhere in article content with:

{itooltip thumbsrc="images/photo.jpg" lgsrc="images/photo-large.jpg" title="Product name" theme="dark" placement="follow"}Short supporting text{/itooltip}

Image triggers show a thumbnail in the article. Text triggers use type="text" with a dashed underline label. Optional link turns the trigger into a URL and adds an Open link action inside the tip.

Four built-in themes: Dark, Light, Glass, and Brand. Override per tip with theme="glass" or set the default in the plugin parameters.

Placement options:

• Follow — tip tracks the cursor
• Top / Bottom / Left / Right — anchored beside the trigger

Plugin defaults cover background, text, accent colour, max width, and corner radius. Shortcodes can still override theme and placement per tip. Local images can be resized and cached as WebP automatically.

Desktop visitors open tips on hover or focus. Click once to pin a tip in place; click outside or press Escape to dismiss. On touch devices, tap opens and pins the tip.

Animations include Fade, Scale, and Slide, plus a None option. Show delay is configurable from 0–800ms. Motion automatically respects the visitor’s reduced-motion preference.

• thumbsrc / thumb — thumbnail image
• lgsrc / image — large preview image
• thumbwidth / width — thumbnail width in pixels
• tipwidth — tip max width override
• title — tip heading
• content — tip body (or use the shortcode inner text)
• type — image or text
• text — label for text triggers
• float — left, right, or none
• theme — dark, light, glass, brand
• placement — follow, top, bottom, left, right
• link — optional HTTP(S), mailto, or tel URL

• Triggers are real buttons or links with keyboard focus styles.
• Tips use role="tooltip" and aria-expanded.
• Escape closes a pinned tip.
• External links use noopener noreferrer.
• Unsafe schemes such as javascript: and data: are blocked.
• Images support lazy loading.
• Reduced-motion preferences disable tip transitions.

• Tip never appears: Confirm the content plugin is enabled and the shortcode uses matching {itooltip} / {/itooltip} tags.
• Editor button missing: Enable Editor - Image Tooltip under Plugins.
• Image missing: Use a site-relative path such as images/photo.jpg or a full https URL.
• Old design remains: Clear Joomla, template, CDN, and browser caches after updating to 3.0.
• Tip hidden by template: Version 3 adds Bootstrap-compatible show class handling for templates that hide [role=tooltip] elements.