About the Image Element
The Image element in GemPages allows you to display single images on your page, which is ideal for showcasing products, banners, brand visuals, promotions, or trust badges.
Whether you want to emphasize a product highlight, illustrate your brand’s aesthetic, or create visual separation between sections, the Image element gives you full control over how images appear across devices.
You can easily upload new images, reuse existing ones from your Shopify files, and customize size, position, borders, and animations without coding.
How to add an Image Element to your page?
Step 1: Log in to your Shopify admin > GemPages Dashboard > Pages.
Step 2: You can see all your pages built with GemPages here. Click on the target page to open the Editor.
If you prefer to build a new page, hit Create new page to start building your page from scratch, or select from pre-designed templates.
Step 3: From the left sidebar, enter Image in the search bar, then drag and drop the image element to the position you prefer.
Configure the Settings Tab
The Image Element offers flexible image settings so you can control size, shape, and responsiveness with ease.
Style
Choose how your image is visually styled:
- Rectangle: Default rectangular shape
- Circle: Automatically crops the image into a perfect circle
Source
Upload or select the image file, you can:
- Click Upload Image, paste the image URL, or hit Browse gallery to choose from your media.
- Once uploaded, the image URL will appear below for reference or editing
Size
Control how the image is displayed in terms of layout and responsiveness:
Frame: Choose a predefined aspect ratio or use a custom one:
- Square
- Vertical
- Horizontal
- Original (keeps the image’s native dimensions)
- Custom (manually set width & height)
Width/Height:
- Set in pixels (px) or percentage (%)
- Toggle the lock icon to maintain or break the aspect ratio
Shape
Style the image container with visual enhancements to better match your design:
Border: Add a border around the image. Customize:
- Color: Choose any HEX color
- Thickness: Set pixel value
- Stroke style: Solid, dashed, or dotted
Corner: Round the image’s corners by adjusting the border radius. You can:
- Apply the same radius to all corners
- Unlock the values to style each corner individually
Shadow: Add a shadow effect to give depth or separation from the background. Configure:
- Type: Outer, inner, or centered
- Direction: Control the shadow angle
- Color
- Distance, Blur, and Size
Link
Make the image clickable by toggling ON, then select the action you want to add after clicking the image, including:
After Click Option | Field(s) Shown | Description |
Open page |
|
Enter a Shopify page, external URL, or anchor (#section-id). |
Scroll to |
|
Input the ID of the section you want to scroll to. |
Open popup |
|
Choose a pop-up to trigger. |
Send email |
|
Define the recipient, optional subject, and message for the mailto link. |
Make phone call |
|
Enter the phone number to dial (mobile devices only). |
SEO
Improve image accessibility and search engine performance:
- Alt text: Describe the image (used by screen readers and search engines)
- Image title: Optional title that may show as tooltip text
Optimize LCP
Helps optimize loading for better performance scores:
Quality: Choose compression level:
- Finest (highest quality)
- High (default, balanced)
- Medium (for performance-heavy pages)
- Custom (advanced compression settings)
Preload: Enable if the image is above-the-fold and contributes to Largest Contentful Paint (LCP)
Align
Align the image within its container: Left, Center, or Right.
Configure the Advanced Tab
For more advanced customization, please navigate to the Advanced tab and follow the instructions in this article.
How to put text over an image?
If you’re interested in creating a banner with text overlay on an image, we’ve got a video tutorial just for you. Watch the video below for step-by-step guidance.
Best practice: Make Your Logo Clickable to the Homepage
If you want visitors to return to your homepage when clicking on your logo, you can set it up easily with the Image element in the editor.
Follow these steps to link your logo to the homepage:
- From the left sidebar, drag and drop the Image element to the top section of your page.
- Click Upload Image and select your logo file from your device or your Shopify media library.
- Click on your uploaded logo image to open its Settings panel in the left sidebar.
- Scroll to the Link section and toggle it ON.
- Choose “Open page” in the After Click field.
- In the Page/link field, enter your homepage URL or select from the available list.
Once done, hit the Save button and publish your page.
FAQs about Image Element
1. How can I stop my image from scaling automatically?
If you do not want an image to scale, go to the Size section in the Image settings. Set the width and height in pixels (px) instead of percentages (%). This locks the image to a fixed size across all devices.
2. Where do I find the image settings in GemPages?
Simply click on the image inside the editor, and the Settings tab will appear in the left sidebar. From there, you can adjust all image settings, including size, frame, border, shadow, and link options.
3. Can I make an image clickable?
Yes. In the Settings tab, scroll down to the Link section and toggle it ON. You can link the image to a page, external URL, section anchor, pop-up, email, or even a phone number.
4. How do I add alt text to an image for SEO?
In the SEO section of the image settings, enter descriptive alt text. This improves accessibility for screen readers and helps search engines understand your image.
5. Why does my image look blurry after upload?
If your image looks blurry, check the Quality setting under Optimize LCP. Switching to Finest quality usually fixes the issue, but make sure the source file you uploaded is high-resolution.
6. Can I overlay text on an image directly?
The Image element itself doesn’t support direct text overlay. For this, use the Hero Banner element, which allows you to place text, buttons, or other elements on top of an image.
7. How do you add images to your page in GemPages?
To add images to a template, drag and drop the Image element into your page layout inside the Editor. You can upload a new file, pick one from your Shopify media library, or paste an image URL. This lets you visually customize any product, collection, or landing page template.
8. How do I update images after publishing my page?
Simply click on the image inside the editor. In the Source section, you can upload a new image, replace it with one from your media library, or adjust its settings. Once updated, click Save and Publish to apply the changes live on your store.
Thank you for your comments