The image shortcode displays a picture on your page or post. This shortcode has a lot of settings for you to configure as you wish – image size, alignment, lightbox and so on.
In this article, we’ll explain how to configuring the image shortcode.
Displaying the image shortcode
To add the shortcode:
| Setting | Description |
|---|---|
| Heading Title | Adds a title for your image. |
| Upload Your Image | Upload your image or select one from media library. |
| Image Link | Links the image to the provided URL. You’ll need to add http:// to the beginning of the URL. If you leave it blank, by default upon clicking on the image, a lightbox will appear, showing a larger version of the image. |
| Target | Opens the link in the same window or a new one. Use this option if you set the Image Link. |
Configuring the image settings
There are a few general settings that allow you to configure the image shortcode to your needs. If you want to change the image size, add a caption or set other stylings, you can edit the options described below.
Configuring the image styling
| Setting | Description |
|---|---|
| Image Size | Adjusts the thumbnails of the image shortcode. Setting the Crop and Resize option will activate the bfi_thumb plugin and will crop the images using the PHP code. If you don’t want to have that plugin activated, select one of the other options. Available options are: Resize & Crop, Original Size, Large Size, and Medium Size. |
| Image Width | Sets the image width. |
| Image Height | Sets the image height. |
| SVG Enable? | If enabled, the max-width property will be added to the image tag. You should enable this option if you are using the SVG format in the image shortcode. |
| Image Frame Style | Sets the frame around the image. |
| Align | Sets the alignment of image. Available options are: Left, Right, and Center. |
| Margin Bottom | Sets the spacing under the image. |
| Drop Shadow | Enable this option to add custom shadow feature. |
| Parallax Scroll | Enable this option to add parallax scroll for this image. |
Configuring the lightbox settings
If you want to zoom in on an image in a frame, you can use the lightbox options below:
| Setting | Description |
|---|---|
| Lightbox | Allows the lightbox to appear upon clicking on the image, which will show a bigger representation of the image. |
| Custom Lightbox URL | Adds a custom URL to the lightbox instead of the default behavior of showing the same image. You can add a URL of a video or another image. You’ll need to add http:// to the beginning of the URL. |
| Lightbox Group Rel | If you use the image shortcode more than once and you want to have the lightbox version of those images shown as a combined lightbox feature with arrows to move between images, add the same value in this option for all image shortcodes of the page. |
Adding an image caption
There are 3 settings that allow you to add image caption and set it inside or outside the image.
| Setting | Description |
|---|---|
| Image Caption Title | Adds a caption title for your image shortcode. |
| Image Caption Description | Adds a caption description for your image shortcode. |
| Image Caption Location | Sets the caption inside or outside the image. |
Configuring the visibility for devices
The Visibility for Devices field in the settings pop-up allows you to configure the visibility of the shortcode on different devices.
You can read the Configuring the visibility for devices article for further explanation.
Adding an entrance animation
The Viewport Animation field in the settings pop-up allows you to hide the shortcode initially and make it visible with animation when you scroll through the browser.
You can read the Configuring a shortcode’s entrance animation article for further explanation.
Adding an extra class name
The Extra Class Name field in the settings pop-up allows you to add an extra class name to the shortcode. It’s useful when you need to target the shortcode in a stylesheet or JavaScript file.
You can read the Adding a custom CSS class to a shortcode article for further explanation.
