Images
Images help you create a rich visual experience that lets visitors see your content in detail.
Images in your CMS asset library only appear in your guide after you attach them to a piece of content, like an item or exhibition.

In This Article
To speed up your image upload process, save all files to a single folder on your desktop or shared drive. To upload many images at once, drag the files from the folder to the Images page in the CMS. Then update how each image appears and add alt text.
Image fields
-
Image: A PNG or JPG file.
Upload images at the highest resolution available. For more, see Asset guidelines.
- Alt text (alternative text): Translate an image’s purpose, context, and key visual information into words. Alt text doesn’t appear as text in your guide. A screen reader reads it out loud to improve or replace the experience of seeing the image in context. For more, see Image alt text.
-
Caption: At a minimum, identify the content of the image and meet your organization’s legal requirements (for example: Paul Manship, Celestial Sphere, 1934). You can also provide context to draw the connection between this image and other guide content. When you tap an image to make it full-screen, the caption appears below the image. The caption appears everywhere the image is used in your guide. For more, see Image captions.
Note: If you leave the caption field blank, the CMS automatically generates a caption with key information about the image's associated content. This only applies the first time you associate an image with content. Depending on the type of content, automatically generated captions vary:
- Items: Creator/Maker, Title in italics, Creation Date/Period/Era
- Botanical items: Common Name, Scientific Name in italics
- Exhibitions, tours, events: Title
- Allow use of this content on Bloomberg Connects digital channels: Indicate whether Bloomberg Connects can use this image on Bloomberg Connects social media channels. We share posts with you before they go live. Where possible, we credit them based on the information in the CMS. For more, see Social media.
Image display formats
There are three image formats in the app: thumbnail, hero, and full screen.
- Thumbnail: The square image that appears in the context of the map, in the list of items included in an exhibition or tour, or in the related content section.
- Dimensions: 315 x 315 pixels
- Hero: The rectangular, landscape image that appears at the top of a content screen.
- Dimensions: 1280 x 720 pixels
- Full screen: The image that appears when a user taps the hero or thumbnail.
- Retains the aspect ratio of the original image. Very large images are resized to a maximum resolution of 4 megapixels.
Update image display defaults
On the About page, you can choose whether the images in your guide fill or fit the thumbnail and hero formats by default. Learn about the difference between fill and fit.
This setting affects all new images that you add to your guide, but you can always change how individual images appear. For the most visually appealing guide, images should fill the thumbnail and hero formats whenever possible.

Crop an image
You can crop the portion of an image that appears in the thumbnail and hero. This doesn't crop the full, original image.
Steps
-
Under the image previews, click Crop.

-
In the form that appears, adjust the selection area. Then click Apply to preview the changes.
- Drag the selection area until the part of the image that you want appears in the frame.
- To zoom in, click +.
- To zoom out, click -.
- To return the image to the last-saved size, click Reset.
-
To remove all zooming and fit the image inside the bounds of the display area, click Fit.
-
At the top of the image form, click Save.

The thumbnail and hero versions of your image are saved. In your guide, the full-screen image appears when a visitor taps the hero image.
Content recommendations
Items, events, tours, and exhibitions always have associated images. The following recommendations will help you use images effectively.
General
- For artwork and botanical Items, choose high-quality images that accurately show the whole work of art, object, or plant. You can add more images that show details or other angles.
- When possible, add multiple images for three-dimensional objects on view. This helps off-site visitors get a better sense of the object. It also helps anyone who can’t move all the way around an object, because of mobility issues or where the object is displayed.
- You can add an image from your content library to more than one piece of content, but avoid using the same image to illustrate more than one item.
- Add alt text to all images.
Image captions
- Images of artworks should always have captions, and other images should almost always have captions.
- Remember that you can attach an image to more than one piece of content. Think about what information the caption needs when the image appears without the related Item fields. For example, the artist name, artwork title, and date are in the item information. Include them in the image caption too, so the artwork is correctly identified if you use the image to illustrate an exhibition.
- Always think about copyright. If your organization has a copyright expert, ask them for advice.
- When an installation photograph shows a single artwork or object, include that artwork’s information and the exhibition name. When multiple artworks or objects are shown, exhibition information may be sufficient, depending on copyright.
For more suggestions and style guides, see Image captions.

