Complementor/Product primary image orientation
Commerce / widget · Elementor module

Product Image Orientation Widget Plugin for Elementor

Show whether a WooCommerce product's image is portrait, landscape or square, with its aspect ratio such as 3:2 and its size in pixels.

Included in All AccessClassic Elementor widgetFrom $29 USD / year
Complementor / Product primary image orientationProduct preview
Text, style and layout controls inside Elementor
01 / Interactive demonstration

Real image orientations

These are the actual published outputs of the widget for sample products and images.

02 / Inside WordPress

Product primary image orientation controls in Elementor

Source picks the current product or a selected one. Display sets the portrait, landscape and square texts, a template with {orientation}, {ratio}, {width} and {height}, how close to square counts as square, an outline in the image's shape and an icon. Style covers typography, colour, alignment, background, border, padding, radius, the outline and the icon.

03 / Website use cases

Where to use product primary image orientation

Buyers of prints, photos, posters and canvases need to know the shape before they think about frames and walls, and a product photo cropped into a square grid hides it. Product primary image orientation reads the size of the product's main image from the Media Library and says whether it is portrait, landscape or square, with the aspect ratio (3:2, 4:5, 16:9 and other common ratios) and the pixel size if you want them, plus an optional outline in the image's own shape.

01

Art print shops

Tell buyers whether a print is portrait or landscape before they choose a frame.

02

Photography

Show the ratio and pixel size of a digital download.

03

Posters and canvases

Mark wide panoramic formats such as 21:9.

04 / Installation and setup

How to show a product image's orientation in Elementor

Start with Complementor installed and your license connected. Enable this module in the WordPress library, then configure it in Elementor.

  1. Install Complementor, connect your license and enable Product primary image orientation in the Complementor library.

  2. Give each product a product image showing the full artwork or photo.

  3. Add the widget to a single product template, or to any page with Source set to a selected product.

  4. Under Display, edit the texts and the template, and turn on the shape mark if you like.

  5. Style the text and panel under Style, then check a portrait and a landscape product.

05 / Content and style controls

Customize product primary image orientation in Elementor

Configure the settings available for this module to suit the page you are building.

  • Current product on product pages and templates, or any selected published product.

  • Editable texts for portrait, landscape and square images.

  • Template with {orientation}, {ratio}, {width} and {height}, such as “Landscape, 3:2 (1,500 × 1,000 px)”.

  • Common ratios (1:1, 5:4, 4:3, 3:2, 16:10, 5:3, 16:9, 2:1, 21:9, 3:1) are recognised within 1.5 %.

  • Images whose sides differ by up to a chosen percentage count as square.

  • An optional outline drawn in the image's own proportions, with its own colour.

  • Typography, colours, surface and an optional icon.

06 / Choose the right approach

Product primary image orientation and Elementor alternatives

Compare the existing Elementor workflow with this Complementor module before choosing your setup.

Writing the format in the description

Fine for a few products, but easy to get wrong when images change.

Product attributes

An Orientation attribute you set by hand can also filter the shop; prefer it when shoppers should filter by shape.

07 / Requirements and compatibility

Product primary image orientation compatibility with Elementor

WordPress 6.5+PHP 8.0+Elementor 3.25+
  • Requires Elementor and WooCommerce.
  • Measures the product image only, not gallery images or variation images.
  • Images without a stored size (such as SVG) show nothing.

Complementor uses classic Elementor APIs. Atomic-native controls are not implemented. Check your theme, cache and integrations on a staging site before release.

08 / Common setup problems

Troubleshoot product primary image orientation

Check these settings if the published page behaves differently from the editor.

Why does nothing show on a product?

The product has no product image; the editor says so.

Why does it say square for a nearly square image?

Images whose sides differ by up to the square tolerance (2 % by default) count as square.

Why is the ratio shown as 2.18:1?

The image does not match a common ratio, so the exact ratio is shown.

Why does nothing show for an SVG?

The Media Library stores no pixel size for it, so the shape cannot be read.

09 / Frequently asked questions

Product primary image orientation plugin questions

Does it need Elementor Pro?

No. It works with the free version of Elementor and WooCommerce.

Which image does it measure?

The product image, at the size it was uploaded to the Media Library.

Does it download or analyse the picture?

No. It reads the width and height WordPress already stored.

Can I hide the pixel size?

Yes. Leave {width} and {height} out of the template.

Does it change the product image?

No. It only describes it.

10 / Annual All Access subscription

Get product primary image orientation with Complementor

This module is included with all 1007 current Complementor solutions. Choose your production website allowance; every plan includes the same modules.

All Access · 1 site

One website

$29USD / year
  • All 1007 current modules
  • Plugin downloads and updates for one year
  • New releases during the paid term
  • Product support
Choose 1 site ↗

Renews at $29 USD each year.

All Access · 5 sites

A few websites

$49USD / year
  • All 1007 current modules
  • Plugin downloads and updates for one year
  • New releases during the paid term
  • Product support
Choose 5 sites ↗

Renews at $49 USD each year.

All Access · 25 sites

More websites

$99USD / year
  • All 1007 current modules
  • Plugin downloads and updates for one year
  • New releases during the paid term
  • Product support
Choose 25 sites ↗

Renews at $99 USD each year.

Applicable taxes extra. Annual subscriptions renew automatically unless canceled in your customer account. Elementor Pro is required for Exclude current post. Read the terms and 14-day technical-issue refund policy.