//// Included in: - user-manual: images: Summary //// .Block and inline image attributes and values [cols="1m,1,2,2"] |=== |Attribute |Value(s) |Example Syntax |Comments |imagesdir |empty, absolute path, relative path or base URL |`:imagesdir: media` |If the image target is a URL or an absolute path, the `imagesdir` prefix is _not_ added; Default is empty value |id |User defined text |`id=sunset-img` + (or `+[[sunset-img]]+` or `[#sunset-img]` above block macro) | |alt |User defined text in first position of attribute list or named attribute |`image::sunset.jpg[Brilliant sunset]` + (or `alt=Sunset`) | |title |User defined text |`title="A mountain sunset"` + (or `.A mountain sunset` above block macro) |Blocks: title displayed below image; Inline: title displayed as tooltip |caption |User defined text |`caption="Figure 8: "` |Only applies to block images. |width |User defined size in pixels |`image::sunset.jpg[Sunset,300]` + (or `width=300`) | |height |User defined size in pixels |`image::sunset.jpg[Sunset,300,200]` + (or `height=200`) | |link |User defined location of external URI |`link=https://www.flickr.com/photos/javh/5448336655` | |scale |A scaling factor to apply to the intrinsic image dimensions |`scale=80` |DocBook only |scaledwidth |User defined width for block images |`scaledwidth=25%` |DocBook only |pdfwidth |User defined width for images in a PDF |`pdfwidth=80vw` |Asciidoctor PDF only |align |left, center, right |`align=left` |Block images only; Align and float attributes are mutually exclusive |float |left, right |`float=right` |Block images only; float and align attributes are mutually exclusive; to scope the float, use a <>. |role |left, right, th, thumb, related, rel |`role="thumb right"` + (or `[.thumb.right]` above block macro) |Inline images can use role to float images left and right; Role shorthand (`.`) can not be used on images |===