Image widget is a modal repository for blocks that allow image uploads in Site Editor. With this modal repository, you can upload, store, and manage your store’s images and use them on different pages, such as Home, Product, or Newsletter.
For instance, you may want to add a new image to your store's Carousel block. You can use the Image Widget to upload the image.
In the following section, Accessing Image Widget, learn how to use it.
Accessing Image Widget
Blocks on Site Editor, which allow you to upload an image, have the Image Widget modal. In this article, we will use the Carousel block as an example. The steps to access the Image Widget are as follow:
- In the VTEX Admin, access Storefront > Site Editor.
- In the right column, select the block to which you desire to upload an image.
- In BANNERS, click on
ADD.
- Click in the Banner Image placeholder.
Once you have completed the previous steps, the Image Widget modal will open on your screen. Now that you know how to access the Image Widget, see what you can do next:
Adding an image
After accessing the Image Widget, you can add images to it:
When adding new images in the Image Widget modal using a development workspace, the performed settings will be saved directly in the master workspace. In other words, they will immediately be reflected in your store's modal.
The maximum file size supported by Image Widget is 4 MB.
- Click on
Add new.
- Choose the image you want to add and click on
Open
. - The modal closes by itself. Click on
APPLY
.
After completing the previous step, your image will be in the block and in your Image Widget repository and is ready to be used on your store pages.
Once you have added an image to the modal, see what else you can do with it in the article Features within Image Widget.
Features within Image Widget
Other features in the modal are searching for images, filtering them by order, and viewing your pictures in a list or grid.
Furthermore, If you added images to your modal, now you can preview them, copy an image URL, download them, and delete them from your repository.
With the modal open, click on more actions
in an image thumbnail.
Options | Description |
---|---|
Preview | Opens a new page to show a preview of the picture. |
Copy URL | Allows you to copy the image’s URL and use it in other sections of your store. |
Download | Downloads the image to your computer. |
Delete | Removes the image from the repository. |
Replacing an image
Go to the block in which you want to replace a picture and:
- Click on
More actions
in an image thumbnail, and select replace. - Click on
More Actions
again and select Replace. - With the modal open, click on an image to replace.
- Click
APPLY
.
Removing an image
To remove a picture in the desired block, click on More actions
in an image thumbnail and select remove. After this, the image will no longer be visible in the block.
When you remove an image, it does not mean it was deleted from the repository. To do that, check the section Features within Image Widget.