Skip to main content

Image Box — converter mapping

Source image_boximage_box. This page shows the recognizer rule and every option on the shortcode, with how the converter fills it — so you can see at a glance which options are mapped, which are reproduced via CSS, and which are left for manual editing.

Recognizer

Priority58
Recognizerimage_box
Matches whenAn image paired with a title + text (a media card / feature block — image beside or above a heading and copy).
Becomesimage_box
Recognizer block shape{ img:{ src, alt, cls }, card:{ title, titleTag, text, link } }
FallbackDegrades to code_block.

The image (with its alt), the title + heading tag, and the body text map natively. Skin (frame, overlay, hover, colours, image side/ratio) is left at defaults.

Option coverage

11/32 options mapped natively (34%) — 🟡 0 via CSS · ⚠️ 5 gaps (derivable, not yet) · ⚪ 16 default · ⚙️ 1 auto.

5 derivable gaps

The ⚠️ rows below are options a source realistically expresses that the converter doesn't derive yet — the real to-do list for improving this element's fidelity. The ⚪ default rows are intentional (no reliable signal, or a UnysonPlus-specific choice).

OptionTabTypeStatusMapped from / note
imageContentupload✅ Nativederived-from source card image src (sideloaded upload value)
image_altContenttext✅ Nativederived-from source img alt attribute
subtitleContenttext⚪ Unmappednot set; no subtitle captured
titleContenttext✅ Nativederived-from card title (stripped tags)
title_tagContentselect✅ Nativederived-from card titleTag (validated h2-h6)
textContentwp-editor✅ Nativederived-from card text/body HTML
iconContenticon⚪ Unmappednot set; image_box path has no icon
custom_iconContenthidden⚪ Unmappednot set
button_styleContentselect✅ Nativederived-from detected CTA (arrow glyph → 'arrow', else 'link')
button_labelContenttext✅ Nativederived-from CTA/link label
sc_design_panelPresetshtml-full⚪ Unmappeddisplay-only html panel; not a stored value
design_settingsDesignmulti-picker⚪ Unmappedhardcoded family 'stacked' (img-title-text); overlay/side not auto-detected
image_ratioDesignselect✅ Nativederived-from source frame aspect (aspect-square/video/[x/y]/img aspect) → ratio slug
content_alignDesignimage-picker⚪ Unmappednot set
image_sizeDesignshort-select⚪ Unmappednot set
hover_effectEffects & Linkselect⚪ Unmappednot set; UnysonPlus-specific
transition_speedEffects & Linkselect⚪ Unmappednot set
link_behaviorEffects & Linkselect✅ Nativederived-from card/CTA href → 'url' when a real link exists
link_urlEffects & Linktext✅ Nativederived-from CTA/card href
link_targetEffects & Linkswitch✅ Nativeset '_self' when a link is present (source target not read → effectively default target)
box_styleStylingborder-style-picker⚠️ Gapsignal: computed border / box-shadow on card wrapper maps to boxp-outline/soft-shadow
image_styleStylingimage-style-picker⚠️ Gapsignal: computed border-radius (rounded/circle) and grayscale filter (monochrome) on image
bg_colorStylingpredefined-colors-color-picker-compact⚠️ Gapsignal: computed background-color of card
font_size_presetStylingselect⚪ Unmappednot set
title_colorStylingpredefined-colors-color-picker-compact⚠️ Gapsignal: computed color of title element
subtitle_colorStylingpredefined-colors-color-picker-compact⚪ Unmappedno subtitle captured
content_colorStylingpredefined-colors-color-picker-compact⚠️ Gapsignal: computed color of body text
icon_colorStylingpredefined-colors-color-picker-compact⚪ Unmappedno icon in image_box path
icon_badge_presetStylingborder-style-picker⚪ Unmappednot set; no icon
accent_colorStylingpredefined-colors-color-picker-compact⚪ Unmappednot set
animation · gsap_motion · interaction · text_effect · scroll_* · flip_card · motion_path · confetti · …Animationsmulti-picker⚪ UnmappedDefault — Animation Engine effects (no source mapping)
spacing · css_id · css_class · custom_css · element_position · element_overflow · dc_*Advancedtext / code-editor⚪ UnmappedDefault — outer spacing + per-instance advanced fields, set by hand
unique_id · custom_attrs · responsive_hideAdvancedgroup⚙️ AutoPlumbing — generated / not set

Status legend

  • Native — Set as the native option from the source.
  • 🟡 Via CSS — Reproduced via scoped CSS / the styler; the native option is left empty (candidate to promote to a native mapping).
  • ⚠️ Gap — A source signal exists, but the converter does not derive this yet — a mapping worth adding (a real TODO, not a limitation).
  • Unmapped — Left at default — no reliable source signal, or an intentional/UnysonPlus-specific choice with nothing to translate.
  • ⚙️ Auto — Plumbing (unique id, custom attrs). Excluded from the coverage percentage.

← Back to Element Mapping