When setting up your store's theme, you'll often want to use images for the brand's visual identity.
Among the many options available in Store Framework for the use of images, you can apply configurations to your theme that directly impact the way in which images are cropped, rendered and displayed to end users.
We have put together a best practices guide that should be followed in order to have your theme's images displayed in the best possible way and thus avoid performance risks when rendering your store's UI.
Images that are uploaded to your theme's code must always use the Assets Builder or the admin's Site Editor.
Declaring the URLs of the desired images directly in the theme's code in the
blocks.json file will prevent the images from matching size when rendered, making the UI's image components deformed due to different dimensions.
The Assets Builder, along with the admin's Site Editor, ensures that uploaded images are cropped to size when rendered in the UI, making their presentation consistent and uniform to end users.
️ Avoid using images whose dimensions are large since Site Editor may not be able to crop it.
VTEX IO Store Framework has so many different blocks that you can often configure one in your theme that's not the best fit for what you're trying to achieve.
It's no different with images. With so many blocks responsible for rendering images on the UI, identifying the best suited block can be a challenge.
Therefore, another best practice is to understand the main functionality of each image block and, consequently, be able to choose the one that best fits your scenario.
The image blocks are:
- Logo - Responsible for rendering your brand's logo. It should preferably be used in your store's Header or Footer.
- Infocard - The Infocard block creates images in the UI which have links and buttons that direct the user's flow. Infocards are recommended in scenarios in which you want to render an image that's specifically tied to a redirect with Call to action buttons/links.
- Rich Text - The Rich Texts blocks are meant to create markdown texts in your UI. It may be a block that seems simple, but it allows plenty of customization, such as passing an image URL to be rendered. The Rich Text is mainly recommended for building text communications that may need to have an image linked to them.
- Product Summary Image - The Product Summary Image block is responsible for displaying the product image usually attached to other product summary informations, such as name and price. This block, exported by the Product Summary, must be displayed within other store components, such as the Shelf.
- Image - The Image block basically renders a image in your store's UI, without links/buttons/markdown texts/product info summary attached to it. It is responsible solely for rendering an image of your choosing in your store's theme.
When we talk about product images being rendered in the Product Summary component, a best practice is to use the
maxHeight props pertaining to the
These props define image dimensions and enable you to let Product Summary images be of identical size when rendered (even if each image was originally submitted with a different size in the admin's Catalog).
️ You do not have to use these 4 props at the same time in your Product Summary Image block. Each one of them has its own functionality and can be used independently.
This in turn allows your store's Shelf, for example, to have image consistency across all products being displayed, differently from the Shelf example below:
To implement these props in your theme, access the Product Summary Image block documentation.
Updated 22 days ago