Add Report Image

Images uploaded to the CMS must be high-resolution and should be saved with the recommended naming convention. Find step-by-step guidance on saving images on the Publish Reports in the CMS page, with additional troubleshooting information available below.

Adding an image

1. From the Content tab in the CMS Create Report editor, select the Add Report Image content block. 

2. Title Text: Paste the figure title into the text field.

3. Caption: This optional field can be used to provide additional detail or description not captured by the title. This is a useful field to use when a title is particularly long and some information can be pulled out from a title into a caption.

4. Image: Select Add media.

   1. You can add one or more images to the Media Library by dragging and dropping files to the gray Image upload box or choose Select files > select the file(s) from your folder library > Open. Complete the following on the upload screen:

      1. Alternative text: Provide alternative text summarizing the image using the Writing Alt Text guidance.

      2. Language: The language should match the language of the report. Select from the drop-down menu.

      3. Click Save. The images will appear in the Media Library as selected (with a blue outline and checkmark). Deselect any additional images you have uploaded at this time to leave a single file selected.

   2. You can alternatively select a previously uploaded image from the Media Library. Older uploads can be searched for using the Name field. Review naming guidance.

   3. Click Insert selected.

5. Source:

   1. Source Title: Paste the source title for the image into the text field. If no source should be listed for the image, leave the field blank.

   2. URL: Paste a source link if applicable. Keep the auto-populated text “<nolink>” if you are including a Source Title that does not need a URL link.

6. Show Figure Label: Click button to toggle on (button should appear green) for any image that should have a figure label. Do not turn the toggle on for AFI maps, HFA maps, or Seasonal Calendars.

7. Show full width in PDF: Turn toggle on for figures that you would like to display full-width in the web-generated PDF. Always set Seasonal Calendars to full-width.

8. Float Position: The float position determines where the image will be located in the report PDF. By default, images float right; that is, they are placed in the right hand side of the PDF. To position images side-by-side in the PDF, set the first image to Float: Left and the second image to Float: Right.

Bulk upload images

You have the option to upload multiple image files directly to the Media Library before adding them to a report.

1. From the admin toolbar at the top of the website, go to Content > Add media > Media library.

2. Select + Add media to upload a single file or + Upload media in bulk to add multiple files.

3. Select Image.

4. Drag and drop your file(s) onto the gray Image upload box or click Select files to choose the file(s) from your computer.

5. Complete the following on the upload screen:

   1. Alternative text: Provide alternative text summarizing the image using the Writing Alt Text guidance.

   2. Language: The language should match the language of the report. Select from the drop-down menu.

   3. Click Save.

6. Your images should now appear in the Media Library. When filling out a Report Image block in your report you will click the Add media button, select a file you uploaded to the Media Library, then click Insert selected.

Layout options

You can break up text into multiple Section Content blocks to place images either right before or right after the paragraph where the figure is referenced. Further guidance on arranging text and images can be found below and on the PDF Formatting page.

It is helpful to preview the PDF after adding a few images and/or Visualizations so you can adjust the layout as needed while building your report.

To preview your PDF, click Save and Preview to view the report webpage, then click the Download the Report button. Use the examples below to adjust the settings for text and images as needed.

A single image with text wrapped

Within the CMS, place items in the order below, and use the default settings:

1. Image

2. A Section Title or Section Content block that includes the text that will wrap around the figure.

Two images stacked vertically with a large block of wrapped text

Within the CMS, place items in the order below, and use the default settings:

1. First image

2. Second image

3. A Section Title or Section Content block that includes the text that will wrap around the images.

If the first image fits on a page, but the second image doesn’t, this may create a gap of white space.

If this happens, review the Common Issues and Solutions.

Two images side by side

Place items in the order below, using the indicated settings:

1. First image: Float left

2. Second image: Float right

If, as in the example here, your images are not the same size and you want the text not to wrap, you will need to turn on the Show full width in PDF toggle for the text block.

Image troubleshooting

If your image isn’t showing up well on the report webpage or in the PDF, try the solutions listed below to make it clear and accessible.

Blurry image

If your image is blurry, try the following:  

1. Check how you saved the image. Is it coming directly from the original source, or has it been saved multiple times? Try to obtain the original image if possible and refer back to the guidance on preparing images.

2. If your image is a screenshot, zoom in before recapturing the image. 

Image is too small in the PDF

If your image is too small to be readable in the PDF: 

1. Use the Show full width in PDF toggle to set the image to take up the full width of the PDF page. Seasonal calendars should always be set to full width.

2. Consider whether the image itself can be adjusted to improve the sizing.