Widgets: Image

Use the image widget to insert an image into your site. You can customize images to act as buttons and navigate to other pages or sites, download files, or activate popups. Images are a great way to decorate sites, show off products or storefronts, and create an additional way to communicate with visitors.

The following image file types are supported:

png, jpg, jpeg, gif, svg, svg+xml, ico, x-icon, webp

Note

  • Each site can contain up to 15,000 media files, including images, audio, and files. Additional files result in an error message. The size limit per file is 50MB.

  • File names should not contain spaces or special characters.

  • When uploading photos to use in your site, make sure to get permission to use photos coming from photographers, businesses, and other third parties.

  • Using the image widget does not change the background picture. Instead, it adds a picture onto a row or column. To learn how to add a background image, see .

For information on adding widgets, see Add Widgets.

Tip

Fore more information on widgets and the widgets library, see Widgets: Library and Overview.

Content Editor

To access the content editor, right click the widget and select Edit Content.

  1. Once an image widget has been added to a site, click the + Image to select an image.

  2. Choose between the existing stock photos in the gallery or click +Upload to add your own image. For more image choice options, click Full View. For more information, see Media Manager, Libraries, and Pickers. The following options are available, once an image is selected:

    • Edit. Change image properties by using the Image Editor.

    • Replace. Select a different image.

  3. The following options are available in the content editor:

    • Link Image. Images can be linked to other pages and URLs, popups, anchors, email addresses and downloadable files. When a visitor clicks on the image, they will be taken to the link.

    • Alt text. Enables search engines to recognize image content. Write text to describe the image.

      • Click All Alt Text to view and manage alt text for all site images.

    • Tooltip. Text shown when a visitor hovers over an image.

    • Caption. Type a caption for the image.

    • Alternate image on-hover.

To learn about optimal image sizes, see Media: Guidelines and Specifications.

Design Editor

To access the design editor, right-click the element, and click Edit Design.

The toggle to turn image optimization off can be found in the Style tab.

Warning

Disabling image optimization could impact page speed and or performance.

For information about design options that are not specific to this widget (for example, layout, style, or spacing), see Widget Design.

FAQs and Troubleshooting

Images are blurry, how do I fix them?

Blurry images can sometimes result from the optimization process. If this occurs, you can disable optimization, though this may affect site speed.

To disable optimization:

  1. To access the design editor, right-click the element, and click Edit Design.

  2. Navigate to the Style area.

  3. Click the toggle for Do not optimize this image.

I received the error "Name already in use" but I have no files with the name

File names can remain cached for a while. If a file with the same name was recently deleted, it is likely still cached, and you will need to use a different name.

Why is the content of my uploaded file incorrect?

A file with the same name may have recently been deleted. File names can remain cached for a while. The file would need to be renamed.

To rename a file, open the Media Manager, select the file and click Rename. If using a library or picker, toggle on the Manage option for the library or picker.

Additional characters are being added to the file name

This is likely due to an existing file with the same name or a recently deleted one. File names can remain cached for a while, so renaming the file may be the best option if you encounter this issue.

To rename a file, open the Media Manager, select the file and click Rename. If using a library or picker, toggle on the Manage option for the library or picker.

How do I get an Image to Show up as the Right Size?

To optimize image sizes for your site:

  • Only upload images as large as they are intended to be used (for example, if the image is going to appear as 300px by 300px on the site, do not upload it as a 4000px by 4000px image).

  • The maximum image size cannot exceed 3,145,728 pixels.

  • Be aware of aspect ratios, as 16:9 images look great on desktop but appear too small on mobile. In this case:

    • Use the Hide on Device feature to create specific versions of the image for each device.

    • Resize the image dimensions (aspect ratio) to fit - size changes are device independent.

An image is failing to upload

There could be a few reasons that would cause a file to fail.

A recommended first step in troubleshooting is testing to see if you're able to upload other images.

If you are able to, this typically indicates the error is related to the file itself or the file size is too large (files can be a maximum of 200MB).

Tip

There are several potential causes that could prevent files from being uploaded, with a common one being that the file is locked. In such cases, the previous owner of the file needs to unlock it and may need to provide a new version.

If you aren't able to, it could be related to:

  • The maximum file limit has been reached (up to 15,000 images, audio clips, and files can be uploaded per site).

  • The browser or device you're using. In this case, clearing cache, trying a different browser or device, or restarting your device might fix it.