  {"id":376,"date":"2023-10-24T14:48:00","date_gmt":"2023-10-24T18:48:00","guid":{"rendered":"https:\/\/carleton.ca\/cutheme-docs\/?page_id=376"},"modified":"2026-08-10T20:10:37","modified_gmt":"2026-08-11T00:10:37","slug":"image","status":"publish","type":"page","link":"https:\/\/carleton.ca\/cutheme-docs\/basic-training\/basic-training-module-3-essential-blocks\/image\/","title":{"rendered":"Image"},"content":{"rendered":"\n<section class=\"w-screen px-6 cu-section cu-section--white ml-offset-center md:px-8 lg:px-14\">\n    <div class=\"space-y-6 cu-max-w-child-5xl  md:space-y-10 cu-prose-first-last\">\n\n            <div class=\"cu-textmedia flex flex-col lg:flex-row mx-auto gap-6 md:gap-10 my-6 md:my-12 first:mt-0 max-w-5xl\">\n        <div class=\"justify-start cu-textmedia-content cu-prose-first-last\" style=\"flex: 0 0 100%;\">\n            <header class=\"font-light prose-xl cu-pageheader md:prose-2xl cu-component-updated cu-prose-first-last\">\n                                    <h1 class=\"cu-prose-first-last font-semibold !mt-2 mb-4 md:mb-6 relative after:absolute after:h-px after:bottom-0 after:bg-cu-red after:left-px text-3xl md:text-4xl lg:text-5xl lg:leading-[3.5rem] pb-5 after:w-10 text-cu-black-700 not-prose\">\n                        Image\n                    <\/h1>\n                \n                                \n                                    \n\n<p class=\"wp-block-paragraph\">Basic Training Module 3: Essential Blocks<\/p>\n\n\n                            <\/header>\n\n                    <\/div>\n\n            <\/div>\n\n    <\/div>\n<\/section>\n\n\n\n<p class=\"wp-block-paragraph\">Images can help make content more engaging, support key messages, and break up large sections of text. The Image block allows you to add images to pages and posts while providing important accessibility and formatting options.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">In this lesson, you&#8217;ll learn how to add images, provide alternative text, and adjust image settings to ensure your content is accessible and visually effective.<\/p>\n\n\n\n<h2 id=\"when-to-use-an-image-block\" class=\"wp-block-heading\">When to Use an Image Block<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Use the Image block when you want to:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Illustrate a concept<\/li>\n\n\n\n<li>Showcase a person, place, or event<\/li>\n\n\n\n<li>Support text content with visuals<\/li>\n\n\n\n<li>Make a page more engaging<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Images should support your content, not replace it. Important information should always be available in text form.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-style-outline is-style-outline--1\"><img loading=\"lazy\" decoding=\"async\" width=\"2178\" height=\"512\" src=\"https:\/\/carleton.ca\/cutheme-docs\/wp-content\/uploads\/sites\/2\/2026\/08\/add-image.png\" alt=\"A view of the placeholder when adding an image in the content editor.\" class=\"wp-image-5339\" srcset=\"https:\/\/carleton.ca\/cutheme-docs\/wp-content\/uploads\/sites\/2\/2026\/08\/add-image.png 2178w, https:\/\/carleton.ca\/cutheme-docs\/wp-content\/uploads\/sites\/2\/2026\/08\/add-image-512x120.png 512w, https:\/\/carleton.ca\/cutheme-docs\/wp-content\/uploads\/sites\/2\/2026\/08\/add-image-1024x241.png 1024w, https:\/\/carleton.ca\/cutheme-docs\/wp-content\/uploads\/sites\/2\/2026\/08\/add-image-320x75.png 320w, https:\/\/carleton.ca\/cutheme-docs\/wp-content\/uploads\/sites\/2\/2026\/08\/add-image-768x181.png 768w, https:\/\/carleton.ca\/cutheme-docs\/wp-content\/uploads\/sites\/2\/2026\/08\/add-image-1536x361.png 1536w, https:\/\/carleton.ca\/cutheme-docs\/wp-content\/uploads\/sites\/2\/2026\/08\/add-image-2048x481.png 2048w\" sizes=\"auto, (max-width: 2178px) 100vw, 2178px\" \/><\/figure>\n\n\n\n<h2 id=\"adding-an-image\" class=\"wp-block-heading\">Adding an Image<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">To add an Image block:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Click the <strong>+<\/strong> button and search for <strong>Image<\/strong>.<\/li>\n\n\n\n<li>Select the Image block.<\/li>\n\n\n\n<li>Choose one of the following options:<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><strong class=\"myprefix-text-bold\">Upload<\/strong><br>Upload an image directly from your computer.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong class=\"myprefix-text-bold\">Media Library<\/strong><br>Select an image that has already been uploaded to your website.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong class=\"myprefix-text-bold\">Insert from URL<\/strong><br>Insert an image using a direct image URL.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Tip:<\/strong> In most cases, it&#8217;s recommended to use the Media Library whenever possible to ensure images are managed within your website.<\/p>\n\n\n\n<h2 id=\"alternative-text-alt-text\" class=\"wp-block-heading\">Alternative Text (Alt Text)<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Alternative text, often called <strong>alt text<\/strong>, provides a text description of an image.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Alt text is important because:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>It helps visitors using screen readers understand image content.<\/li>\n\n\n\n<li>It improves accessibility.<\/li>\n\n\n\n<li>It helps search engines understand images.<\/li>\n<\/ul>\n\n\n\n<h3 id=\"writing-effective-alt-text\" class=\"wp-block-heading\">Writing Effective Alt Text<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Good alt text should describe the purpose or meaning of the image.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Good Example<\/strong>: Student studying in the MacOdrum Library.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Avoid<\/strong>: Image of a student studying in the MacOdrum Library. Screen readers already identify the content as an image.<\/p>\n\n\n\n<h3 id=\"decorative-images\" class=\"wp-block-heading\">Decorative Images<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">If an image is purely decorative and does not add meaningful information, alt text may be left empty.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-style-outline is-style-outline--2\"><img loading=\"lazy\" decoding=\"async\" width=\"1980\" height=\"958\" src=\"https:\/\/carleton.ca\/cutheme-docs\/wp-content\/uploads\/sites\/2\/2026\/08\/image-alt.png\" alt=\"A view of the image settings when working in the content editor.\" class=\"wp-image-5340\" srcset=\"https:\/\/carleton.ca\/cutheme-docs\/wp-content\/uploads\/sites\/2\/2026\/08\/image-alt.png 1980w, https:\/\/carleton.ca\/cutheme-docs\/wp-content\/uploads\/sites\/2\/2026\/08\/image-alt-512x248.png 512w, https:\/\/carleton.ca\/cutheme-docs\/wp-content\/uploads\/sites\/2\/2026\/08\/image-alt-1024x495.png 1024w, https:\/\/carleton.ca\/cutheme-docs\/wp-content\/uploads\/sites\/2\/2026\/08\/image-alt-320x155.png 320w, https:\/\/carleton.ca\/cutheme-docs\/wp-content\/uploads\/sites\/2\/2026\/08\/image-alt-768x372.png 768w, https:\/\/carleton.ca\/cutheme-docs\/wp-content\/uploads\/sites\/2\/2026\/08\/image-alt-1536x743.png 1536w\" sizes=\"auto, (max-width: 1980px) 100vw, 1980px\" \/><\/figure>\n\n\n\n<h2 id=\"captions\" class=\"wp-block-heading\">Captions<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Captions provide additional context below an image.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Captions are useful when:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Identifying people<\/li>\n\n\n\n<li>Providing photo credits<\/li>\n\n\n\n<li>Explaining diagrams or charts<\/li>\n\n\n\n<li>Adding context that may not be obvious from the image alone<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">To add a caption:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Select the image.<\/li>\n\n\n\n<li>Locate the caption field below the image.<\/li>\n\n\n\n<li>Enter your caption text.<\/li>\n<\/ol>\n\n\n\n<h2 id=\"image-alignment\" class=\"wp-block-heading\">Image Alignment<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Images can be aligned within the page layout.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Common alignment options include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Left<\/li>\n\n\n\n<li>Center<\/li>\n\n\n\n<li>Right<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">When aligned left or right, surrounding text may wrap around the image.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Choose an alignment that works well with the surrounding content and maintains readability.<\/p>\n\n\n\n<h2 id=\"image-settings\" class=\"wp-block-heading\">Image Settings<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Additional image settings are available in the sidebar.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Depending on your site&#8217;s configuration, you may see options for:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Image size<\/li>\n\n\n\n<li>Alignment<\/li>\n\n\n\n<li>Linking behaviour<\/li>\n\n\n\n<li>Expand on click<\/li>\n\n\n\n<li>Alt text<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Not all settings are available for every image or site configuration.<\/p>\n\n\n\n<h2 id=\"replacing-an-image\" class=\"wp-block-heading\">Replacing an Image<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">If you need to update an image:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Select the image block.<\/li>\n\n\n\n<li>Click <strong>Replace<\/strong>.<\/li>\n\n\n\n<li>Choose a new image from the Media Library or upload a replacement.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">The image will be updated while preserving the existing block location on the page.<\/p>\n\n\n\n<h2 id=\"best-practices\" class=\"wp-block-heading\">Best Practices<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong class=\"myprefix-text-bold\">Always Add Alt Text<\/strong><br>Most images should include meaningful alt text.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong class=\"myprefix-text-bold\">Use High-Quality Images<\/strong><br>Choose clear images that support the content on the page.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong class=\"myprefix-text-bold\">Add Captions Only When Helpful<\/strong><br>Not all images require captions. Use them when additional context would benefit the reader.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong class=\"myprefix-text-bold\">Avoid Using Images for Text<\/strong><br>Important information should be written as text rather than embedded inside images whenever possible.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong class=\"myprefix-text-bold\">Consider Mobile Devices<\/strong><br>Before publishing, preview your page to ensure images display correctly on smaller screens.<\/p>\n\n\n\n<figure class=\"wp-block-embed alignwide is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio w-screen ml-offset-center cu-max-w-child-7xl px-4 md:px-6 lg:px-12\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"Getting Started with cutheme - Image Block\" width=\"500\" height=\"281\" src=\"https:\/\/www.youtube.com\/embed\/5QnFb5_OyA4?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n\n\n\n<section class=\"w-screen px-6 cu-section cu-section--white ml-offset-center md:px-8 lg:px-14\">\n    <div class=\"space-y-6 cu-max-w-child-5xl  md:space-y-10 cu-prose-first-last\">\n\n        \n    \n    <dl class=\"cu-description cu-component-updated\">\n        \n    <div class=\"grid pt-4 pb-3 border-b accordion border-cu-black-100 md:pt-6 md:pb-5 first:border-t\">\n        <dt class=\"font-semibold not-prose\">\n            <button class=\"flex items-center justify-between w-full text-left accordion__button\" aria-expanded=\"false\" aria-controls=\"accordion-transcript-image-block\">\n                <span class=\"flex-1 ml-auto text-left break-words whitespace-normal cu-icon\">\n                    Transcript \u2013 Image Block\n                <\/span>\n                <svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" fill=\"none\" viewbox=\"0 0 24 24\" stroke-width=\"1.5\" stroke=\"currentColor\" aria-hidden=\"true\" data-slot=\"icon\" class=\"w-5 h-5 ml-auto transition-transform rotate-0 accordion__icon text-cu-black-500\">\n                    <path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M8.25 4.5l7.5 7.5-7.5 7.5\"><\/path>\n                <\/svg>\n            <\/button>\n        <\/dt>\n        <dd class=\"p-0 mt-0 cu-prose cu-prose-first-last accordion__content md:p-0 md:mt-0\" hidden=\"\" id=\"accordion-transcript-image-block\">\n            \n\n<p class=\"wp-block-paragraph\">Welcome to getting started with cutheme, module 3.&nbsp;<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This video is going to introduce you to using the image block. Let\u2019s start by adding an image block.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The image block allows you to add images to all of your pages and your posts. To do this you have two options. First, you can click upload to upload the images from your computer. And uploading an item this way means it will also add that image to your website\u2019s media library. This means that it can be used across the site by anybody.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Next, you can select an image from the media library. Once you pull up the media library, you\u2019ll have access to all of the images that have already been uploaded to your website. Click on one of those images and then press select. Now have a look over here at the block options on the right. This is where you can add alternative text to describe the image. And you can also choose the size \u2013 whether you want to have a thumbnail, medium, or full-size image.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When you click on the image, you\u2019ll also notice that you have a contextual menu up here at the top. Use this contextual image for alignment. You can align your image to the left or the right. You can also add a caption. And if you need to replace the image simply click on the replace button and you can choose something different from your media library.<\/p>\n\n\n        <\/dd>\n    <\/div>\n\n\n    <\/dl>\n\n\n    <\/div>\n<\/section>\n\n\n\n<h2 id=\"try-it-out\" class=\"wp-block-heading\">Try it Out<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Practice working with the Image block.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Add an Image block to a page.<\/li>\n\n\n\n<li>Upload or select an image from the Media Library.<\/li>\n\n\n\n<li>Add meaningful alt text.<\/li>\n\n\n\n<li>Add a caption.<\/li>\n\n\n\n<li>Experiment with different alignment options.<\/li>\n\n\n\n<li>Preview the page and review how the image appears on the front end.<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"<p>Learn how to add images, write effective alt text, and use image settings to create accessible and engaging content.<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":82,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_cu_dining_location_slug":"","footnotes":"","_links_to":"","_links_to_target":""},"cu_page_type":[65],"class_list":["post-376","page","type-page","status-publish","hentry","cu_page_type-basic-training-module-3"],"acf":{"cu_post_thumbnail":""},"_links":{"self":[{"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/pages\/376","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/comments?post=376"}],"version-history":[{"count":5,"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/pages\/376\/revisions"}],"predecessor-version":[{"id":4688,"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/pages\/376\/revisions\/4688"}],"up":[{"embeddable":true,"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/pages\/82"}],"wp:attachment":[{"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/media?parent=376"}],"wp:term":[{"taxonomy":"cu_page_type","embeddable":true,"href":"https:\/\/carleton.ca\/cutheme-docs\/wp-json\/wp\/v2\/cu_page_type?post=376"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}