--- title: "Image and Slideshow Best Practices" slug: "image-and-slideshow-best-practices" description: "Follow these best practices for placing images on your site to ensure responsive design, usability, and compliance with accessibility standards." updated: 2026-04-23T19:15:30Z published: 2026-04-23T19:15:30Z canonical: "www.civicplus.help/image-and-slideshow-best-practices" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://www.civicplus.help/llms.txt > Use this file to discover all available pages before exploring further. # Image and Slideshow Best Practices For a site to operate correctly in a responsive design and throughout different platforms and to maximize web usability, please follow these best practices when you place images on your page. ## Image Size Images inside the content area should be large enough to display clearly on a desktop, tablet, or mobile device as well as on devices that use a high-resolution screen, like the iPhone, newer Android devices, and most iPads. There are specific image requirements for the following: - [Calendar](/municipal-websites-central/docs/image-size-recommendation-for-calendar) - [Facebook](/municipal-websites-central/docs/image-size-recommendations-for-facebook) - [News Flash](/municipal-websites-central/docs/image-size-recommendation-for-news-flash) - [Staff Directory](/municipal-websites-central/docs/image-size-recommendation-for-staff-directory) - [Social Media/RSS](/municipal-websites-central/docs/image-size-recommendations-for-facebook) --- ## Clip Art and Stock Images Clip art and stock images should not be used in your content. Choose images that add value to the content. Decorative images can make information harder to access for people using assistive technology. Read more about [Web Content Accessibility Guidelines (WCAG) 1.1.1](https://www.w3.org/TR/UNDERSTANDING-WCAG20/text-equiv-all.html). --- ## Number of Images Per Page In most cases, one or two static photos per page are the maximum. Additional photos should be placed in a [slideshow widget](/municipal-websites-central/docs/add-the-slideshow-widget-to-a-page) or in the [Photo Gallery module](/municipal-websites-central/docs/add-photos-using-live-edit-photo-gallery). > [!WARNING] > **Note**: The more images you have, the longer the load time the page can experience. --- ## Alternative (Alt) Text Descriptive alternative text should be used in images. For instance, an alternative text should be "black and white police cruiser with lights on" instead of "cop car." Read more on our [Create Alt Text for Images page](/municipal-websites-central/docs/create-alt-text-for-images). **Reasoning:** Alternative text is important when using a screen reader to access the site and for [WCAG 1.1.1](https://www.w3.org/TR/UNDERSTANDING-WCAG20/text-equiv-all.html). --- ## Slideshows Images in slideshows should be the same size to prevent displaying white space to fill the unused space in the slideshow with a smaller image. It is recommended the photos be appropriately and consistently sized and/or edited before being uploaded to the site or widget. Additionally, try to limit the number of photos in each slideshow to a dozen or so images. ### Compliance In the options, slideshows are required to display **Next/Previous Arrows**, as well as **Pagination**. These options are checked by default when [adding a slideshow widget to your page](/municipal-websites-central/docs/add-the-slideshow-widget-to-a-page). Read more about [WCAG 2.2.2](https://www.w3.org/TR/UNDERSTANDING-WCAG20/time-limits-pause.html). - **Moving, blinking, scrolling**: For any moving, blinking, or scrolling information that starts automatically, lasts more than five seconds, and is presented in parallel with other content, there is a mechanism for the user to pause, stop or hide it unless the movement, blinking, or scrolling is part of an activity where it is essential. - **Auto-updating**: For any auto-updating information that starts automatically and is presented in parallel with other content, there is a mechanism for the user to pause, stop, or hide it or to control the frequency of the update unless the auto-updating is part of an activity where it is essential. Therefore, it is recommended that pagination be used on slideshows. ![The Slideshow widget with Next/Previous Arrows and the Next/Previous Arrow Background toggles highlighted.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Slideshow%20Next%20and%20Previous%20Arrows%20Options%20-%20MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A31%3A22Z&se=2026-11-22T14%3A31%3A22Z&sr=b&sp=r&sig=G3DNKoCLbPU5JuVHpmVXHfrbBUNbXT0enhq0dSVw%2Bsg%3D) ![The Slideshow widget with the Pagination toggle highlighted.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Slideshow%20Widget%20Pagination%20Options%20-%20MWC.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A31%3A22Z&se=2026-11-22T14%3A31%3A22Z&sr=b&sp=r&sig=Grv3ELN7Qtg4MiKzIO06ncK%2B0ps0zEfd%2FGNTVzIfLtA%3D) --- ## Image Manager You can [upload any number of images](/municipal-websites-central/docs/add-the-image-widget-to-a-page) to the Image Manager for a specific page. The images will only be available within the specific NID uploaded on, or within a category for module pages. The directory link appears on the left, and our built-in image tools are on the right pane. To avoid confusion, we recommend that you periodically clean out old images if no longer used. > [!CAUTION] > **Warning:** If an image is removed from the image manager that is currently in use, the image will display as an error (blank image with red x). --- ## Supporting Articles - [Find Image Size and Dimensions](/municipal-websites-central/docs/find-image-size-and-dimensions) - [Add the Image Widget to a Page](/municipal-websites-central/docs/add-the-image-widget-to-a-page) - [Add Images to a Slideshow Widget](/municipal-websites-central/docs/add-the-slideshow-widget-to-a-page) - [File Size Limit for Uploads](/municipal-websites-central/docs/file-size-limit-for-uploads)