{"id":244,"date":"2020-05-18T14:02:31","date_gmt":"2020-05-18T14:02:31","guid":{"rendered":"https:\/\/university-communications.ncsu.edu\/documentation\/?page_id=244"},"modified":"2026-07-29T09:39:11","modified_gmt":"2026-07-29T13:39:11","slug":"image-block","status":"publish","type":"reference-article","link":"https:\/\/university-communications.ncsu.edu\/documentation\/reference-article\/image-block\/","title":{"rendered":"Image Block"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">Adding an Image<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Images contained within the image block can be sourced from three different locations:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Uploads from the creator&#8217;s computer (which will be stored in the Media Gallery for reuse)<\/li>\n\n\n\n<li>Images already uploaded to the Media Gallery<\/li>\n\n\n\n<li>URLs for images hosted elsewhere<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Alignments<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Several alignment options are available for images displayed in posts, which affects how widely (or narrowly) the image will display. <\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Content Width (Default)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">By default, inserted images will display at the same width as the post content unless otherwise specified. In most cases this is probably the best option to use.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">There is no button to specifically select content width alignment. If the creator chooses a different alignment option and decides to return to content width, simply toggle the alternate alignment option off.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1360\" height=\"984\" src=\"https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/image-alignment-example.gif\" alt=\"An animated example of selection and deselection of image alignment options.\" class=\"wp-image-264\"\/><figcaption class=\"wp-element-caption\">An animated example of selection and deselection of image alignment options.<\/figcaption><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Wide Width<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">For larger, more impactful images, the &#8220;Wide&#8221; image alignment allows the image to display slightly wider than the post content width.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"1003\" src=\"https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/wide-alignment-example-1024x1003.png\" alt=\"An example of the 'wide alignment' option of Image Blocks\" class=\"wp-image-269\" srcset=\"https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/wide-alignment-example-1024x1003.png 1024w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/wide-alignment-example-300x294.png 300w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/wide-alignment-example-768x752.png 768w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/wide-alignment-example.png 1454w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Full Width<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><em>This option is available on immersive template posts only.<\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For large images in immersive template posts, the &#8220;Full&#8221; alignment option will allow the image to stretch even wider than the &#8220;Wide&#8221; option. Keep in mind that this alignment option can create a very large visual footprint relative to the surrounding text.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"856\" src=\"https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/full-alignment-example-1024x856.png\" alt=\"Example of the full alignment option of the image block.\" class=\"wp-image-270\" srcset=\"https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/full-alignment-example-1024x856.png 1024w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/full-alignment-example-300x251.png 300w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/full-alignment-example-768x642.png 768w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/full-alignment-example.png 1532w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Right Alignment<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><em>This option is available on pages only.<\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The &#8220;Right&#8221; alignment option allows images to float to the right of text content. This option is ideal for supporting imagery that doesn&#8217;t necessarily need to capture a reader&#8217;s full attention but that still gives additional context to surrounding text-based content.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"512\" src=\"https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/right-alignment-example-1024x512.png\" alt=\"Example of a floated right aligned image block\" class=\"wp-image-272\" srcset=\"https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/right-alignment-example-1024x512.png 1024w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/right-alignment-example-300x150.png 300w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/right-alignment-example-768x384.png 768w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/right-alignment-example-1536x768.png 1536w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/right-alignment-example.png 1608w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Note:<\/strong> Floated elements, such as right-aligned images, work best when placed next to enough text-based content to balance the height of the image. In cases where text is sparse, element overlapping may occur. Users should preview pages to verify all blocks are displaying appropriately when using this option.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Center Alignment<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><em>This option is available on posts only.<\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The &#8220;Center&#8221; alignment option is optimal for smaller images, or images that are taller than they are wide. These images will display slightly narrower than the post content width, and unlike other alignment options, captions are placed to the right of the image. This alignment option may also be useful for displaying headshots.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"834\" src=\"https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/center-alignment-example-1024x834.png\" alt=\"Example of the center alignment option of the image block\" class=\"wp-image-273\" srcset=\"https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/center-alignment-example-1024x834.png 1024w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/center-alignment-example-300x244.png 300w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/center-alignment-example-768x625.png 768w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/center-alignment-example-1536x1251.png 1536w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/center-alignment-example.png 1604w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Sizes<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Image size can be manually set to control the crop size. By default, most images uploaded at over 1024px width or height will automatically have four crop sizes available:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Full:<\/strong> The full, original size of the image uploaded<\/li>\n\n\n\n<li><strong>Large:<\/strong> Maximum 1024px width and height<\/li>\n\n\n\n<li><strong>Medium:<\/strong> Maximum 300px width and height<\/li>\n\n\n\n<li><strong>Thumbnail:<\/strong> 150px x 150px square<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Images smaller than 1024px width or height will have fewer crop sizes available.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When using the default image alignment (corresponding to post content width), these image sizes can be used to specify which image crop is used. In most cases, using the default &#8220;Large&#8221; size is a good option. Keep in mind that WordPress will sometimes automatically assign an image size, which may or may not be accurate.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"300\" height=\"570\" src=\"https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/image-size-selection.gif\" alt=\"A screenshot of the &quot;Image size&quot; option within the block settings for an image. \" class=\"wp-image-280\"\/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Alignment Compatibility<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Some combinations of size and alignment options may not display correctly, especially when selecting smaller image sizes with wider alignment options. In these cases, a small image size may stretch to fit the alignment area, resulting in degraded image quality. For example, selecting a &#8220;Thumbnail&#8221; image size of 150px while also selecting the &#8220;Full&#8221; alignment option will result in a 150px-wide image being stretched to the full width of the page. Other combinations may be less drastic, but creators should nonetheless preview all page layouts to ensure that all images are displaying with their intended clarity.<\/p>\n\n\n\n<figure class=\"wp-block-image size-medium\"><a href=\"https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/size-mismatch-example.png\" data-fullsize=\"1068x1128\" data-zoom=\"true\"><img loading=\"lazy\" decoding=\"async\" width=\"284\" height=\"300\" src=\"https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/size-mismatch-example-284x300.png\" alt=\"An example of the 'Thumbnail' size paired with the 'Wide Alignment' option, resulting in significant image blurriness.\" class=\"wp-image-277\" srcset=\"https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/size-mismatch-example-284x300.png 284w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/size-mismatch-example-970x1024.png 970w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/size-mismatch-example-768x811.png 768w, https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/size-mismatch-example.png 1068w\" sizes=\"auto, (max-width: 284px) 100vw, 284px\" \/><\/a><figcaption class=\"wp-element-caption\">An example of the &#8220;Thumbnail&#8221; size paired with the &#8220;Wide&#8221; alignment option, resulting in significant image blurriness.<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Lightboxing<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">For detailed or visually complex images, it may be advantageous to allow the image to be lightboxed when a user clicks on it. This allows the image to stretch larger than may otherwise be allowed by the template, and it presents the image against a dark background for distraction-free viewing.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1850\" height=\"1144\" src=\"https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/image-block-lightboxing-example.gif\" alt=\"Example of lightboxing effect.\" class=\"wp-image-267\"\/><figcaption class=\"wp-element-caption\">Example of lightboxing effect.<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">To enable lightboxing for an image, click &#8220;Insert Link&#8221; on the Image block controls toolbar, and select &#8220;Media File.&#8221;<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1060\" height=\"854\" src=\"https:\/\/university-communications.ncsu.edu\/documentation\/wp-content\/uploads\/sites\/21\/2020\/05\/image-block-media-file-example.gif\" alt=\"In the editor, link to the media file to enable lightboxing.\" class=\"wp-image-266\"\/><figcaption class=\"wp-element-caption\">In the editor, link to the media file to enable lightboxing.<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Accessibility<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">When working with images, users should be mindful about whether all accessibility needs are being met. This may include inclusion of alt text, use of captions, or inclusion of alternate-format data attachments if the image is complex (such as a graph).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Users should be familiar with university accessibility requirements and best practices. See the following resources for help:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a rel=\"noreferrer noopener\" href=\"https:\/\/www.w3.org\/WAI\/tutorials\/images\/decision-tree\/\" target=\"_blank\">W3.org WAI alt Decision Tree<\/a><\/li>\n\n\n\n<li><a rel=\"noreferrer noopener\" href=\"https:\/\/www.w3.org\/WAI\/tutorials\/images\/\" target=\"_blank\">W3.org WAI Images Tutorial<\/a><\/li>\n\n\n\n<li><a rel=\"noreferrer noopener\" href=\"https:\/\/accessibility.ncsu.edu\/\" target=\"_blank\">Accessibility at NC State<\/a><\/li>\n<\/ul>\n\n\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_acf_changed":false,"ncst_custom_author":"","ncst_show_custom_author":false,"ncst_dynamicHeaderBlockName":"ncst\/default-header","ncst_dynamicHeaderData":"{\"pageIntro\":\"Straightforward in concept, the Image Block contains several layout and sizing options to purposefully display images in the best way possible across pages and posts.\"}","ncst_content_audit_freq":"","ncst_content_audit_date":"","ncst_content_audit_display":false,"ncst_backToTopFlag":"","_links_to":"","_links_to_target":""},"availability":[49],"content-type":[51],"class_list":["post-244","reference-article","type-reference-article","status-publish","hentry","availability-nc-state-theme","content-type-block"],"acf":[],"_links":{"self":[{"href":"https:\/\/university-communications.ncsu.edu\/documentation\/wp-json\/wp\/v2\/reference-article\/244","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/university-communications.ncsu.edu\/documentation\/wp-json\/wp\/v2\/reference-article"}],"about":[{"href":"https:\/\/university-communications.ncsu.edu\/documentation\/wp-json\/wp\/v2\/types\/reference-article"}],"version-history":[{"count":14,"href":"https:\/\/university-communications.ncsu.edu\/documentation\/wp-json\/wp\/v2\/reference-article\/244\/revisions"}],"predecessor-version":[{"id":39973,"href":"https:\/\/university-communications.ncsu.edu\/documentation\/wp-json\/wp\/v2\/reference-article\/244\/revisions\/39973"}],"wp:attachment":[{"href":"https:\/\/university-communications.ncsu.edu\/documentation\/wp-json\/wp\/v2\/media?parent=244"}],"wp:term":[{"taxonomy":"availability","embeddable":true,"href":"https:\/\/university-communications.ncsu.edu\/documentation\/wp-json\/wp\/v2\/availability?post=244"},{"taxonomy":"content-type","embeddable":true,"href":"https:\/\/university-communications.ncsu.edu\/documentation\/wp-json\/wp\/v2\/content-type?post=244"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}