Gallery Widget | SHOP Builder

4. EC + SC (EN).png

With SHOP Builder, when adding/editing advanced pages, you can use image widgets to enrich your tab with more images and make it more aesthetically pleasing. 

⚠️ Before you begin:

  • SHOP Builder currently only supports Ultra Chic, Kingsman, Varm, and Philia theme templates.
  • After creating a page using SHOP Builder, the page can still be displayed even if you switch to other theme templates, but it cannot be edited and the layout may be messed up. Please take note of this before publishing the page.


1. Add an image widget 

Step 1

Proceed to SHOPLINE Admin > [Online Store Design] > [Pages] and click the [Advanced Page/Edit] button to open the Advanced Page setup. Screen_Shot_2022-06-30_at_11.06.19_AM.png


Step 2

Click the Widget button. Screen_Shot_2022-06-17_at_11.03.01_AM.png

Step 3

Select the Gallery widget.  Screen_Shot_2022-06-30_at_10.29.15_AM.png


Step 4

1. Bulk upload

The system sorts according to the modification date of the image file, from top to bottom, from the most recently edited to the previous edited.

2. Single upload

You can also upload one image at a time, and the thumbnails are sorted in the same way as bulk uploads.


  • Currently supports adding up to 16 images. 
  • If the upload fails due to the image file format, quantity, etc., the following error prompt may appear
    • Upload failure
      Error message: Fail to upload image (cannot display any thumbnails)
    • Partial upload failure
      Error message: Fail to upload some images (Automatically skip error files while displaying thumbnails)


If you added multiple images, click the ___2022-06-30___10.34.59.png icon on the left to drag and adjust the image order. move_thumbnail_EN.png


Step 5

Click the image widget to separately upload for desktop and mobile interfaces. 

*Note: It is recommended that the desktop version image width be greater than 2000 px, and the mobile version image width should be greater than 1080 px. Screen_Shot_2022-06-17_at_11.47.09_AM.png

Click the language drop-down menu, and a list of supported languages will be listed. You can individually upload the images for each separate language interface. Screen_Shot_2022-06-30_at_11.39.37_AM.png

Step 6

Edit image-related settings.

  • Image cropping: Select which part of the image to crop and display (Top left/Top middle/ Top right/ Middle left/ Middle center/ Middle right/ Bottom left/ Bottom middle/ Bottom right). 
  • Image Alt Text: Enter the image alt text. Use a sentence to describe the image's content to help the search engine better understand the image's content. To learn more about image ALT descriptions, please refer to this article
  • Mask: Select the degree of masking the image.
  • Title: Enter the image title. 
  • URL link: Add a URL to the image so that when customers click on it, they will be redirected to a new page. 
    You can select the method to open the link with: 
    • Current window: Open the URL with the current window. 
    • New window: Open the URL in a new window. 



Step 7

Supports other settings. 

A. Full Screenfull_screen_2023_EN.png

Full Screen mode not switched on:

Full Screen mode switched on:


B. Padding

Adjust the padding of the image and page.padding_2023_EN_copy.png


C. Image per row

You can individually set the number of images in each row of the desktop and mobile versions. image_per_row_EN_2023.png


D. Image proportions

You can individually set the image proportions on the desktop and mobile versions.

  • Recommended image proportions for the desktop version
    • Rectangular (2:1 ratio) - Recommended single image dimension: 2000 x 1000px.
    • Rectangular (3:4 ratio) - Recommended single image dimension: 1500 x 2000px
    • Square (1:1 ratio) - Recommended single image dimension: 2000 x 2000px.
    • Original image proportion
  • Recommended image proportions for the mobile version
    • Rectangular (2:1 ratio) - Recommended single image dimension: 1080 x 540px.
    • Rectangular (3:4 ratio) - Recommended single image dimension: 810 x 1080px
    • Square (1:1 ratio) - Recommended single image dimension: 1080 x 1080px.
    • Original image proportion



E. Text Alignmentalignment_2023_EN.png


Step 8

During the setting process, you can click the Save button below to view the newly added gallery widget on the preview screen to the right.

*Note: You can select whether to preview the desktop version or the mobile version. save_2023_EN.png


Or click the Preview button on the top right to preview it at the storefront.  Preview_2023_EN.png


Step 9

Once the settings above are confirmed, click Publish to let the customers view the newly updated content.publish_2023_EN_copy.png


Read more






Have more questions? Submit a request