From Unit Converter to Unit-Aware Quantities & Calculators

Description

Enhance your product pages with inline unit-aware Quantities and interactive unit-aware sizing calculators powered by CalcsLive. Makes it easier for customers to choose the right size and quantity before checkout. Help Reduce support inquiries and product returns.

Free: a) Unit-aware Quantity shortcodes that let visitors toggle between metric and imperial units in your product specifications—no account required; b) Calculator embedding: 2 pages on 1 domain for Free tier.

Pro: Embed powerful sizing and quantity calculators from CalcsLive that guide customers to the right product configuration.

No Separate Unit Converter Any More. Welcome to Unit Freedom.

If you came here looking for a traditional Unit Converter plugin, we have good news: you don’t need one. Traditional layout-breaking widgets, clunky sidebars, and confusing pop-up calculators belong in the past. CalcsLive eliminates the need for an external converter by introducing Unit-aware Quantities directly into your product specifications.

Backed by a mathematically unified core engine, SI (Metric) and Imperial units are treated with equal parity and absolute consistency. There are no secondary hidden approximations or sloppy conversions — whether your data is entered in millimetres or inches, every Self-converting Quantity handles the math natively on the client side.

You and your visitors enjoy total Unit Freedom to toggle between regional standards seamlessly, building checkout confidence while preventively reducing returns.

Perfect For

  • E-commerce stores – AC sizing, concrete quantity, flooring coverage, paint calculators
  • Technical products – Specifications with live unit-aware quantities (mm inches, kg lbs)
  • Building materials – “How many bags do I need?” calculators
  • Industrial equipment – Belt sizing, cylinder selection, capacity calculators

Key Features

  • 570+ Units, 67 Categories – Full CalcsLive unit library: length, mass, temperature, pressure, force, flow rate, and more
  • Unit-aware Quantity Shortcodes – Free, no account needed. Every quantity on your page becomes a Self-converting Quantity — no separate converter tool required: [calcslive_qty], [calcslive_qty_pair], [calcslive_qty_triplet]
  • Calculator Embed – Embed full buying calculators: [calcslive id="YOUR_ID"]
  • Gutenberg Block – Visual editor with live preview
  • Responsive – Works on desktop, tablet, and mobile
  • Lightweight – Scripts load only on pages that use them
  • Reduce Returns Preventively – Helps customers choose right before purchase, and businesses reduce returns and all associated hassles, contrary to conventional reactive solutions

Unit-aware Quantity Shortcodes

Three shortcodes cover the full range of product specification formats. All are free, client-side, and require no CalcsLive account:

Single Quantity[calcslive_qty]

A single unit-aware value. Visitors click the unit label to switch to any compatible unit. Use for individual specs like weight, length, pressure, or temperature.

[calcslive_qty value=25.4 unit="mm"]  displays 25.4 mm with a dropdown to convert to inches, cm, feet, and more.

Quantity Pair[calcslive_qty_pair]

Two linked values that convert in sync. Supports two formats:

  • 2D dimensions[calcslive_qty_pair values="10x20" unit="cm"] — both values convert together (e.g. product footprint L × W)
  • Coordinates or range[calcslive_qty_pair values="(10, 20)" unit="cm"] — for temperature ranges, coordinate pairs, or min/max specs

Both values update simultaneously when the visitor switches units — no mismatched pairs.

Quantity Triplet[calcslive_qty_triplet]

Three linked values that convert in sync. Supports two formats:

  • 3D dimensions[calcslive_qty_triplet values="10x20x30" unit="cm"] — for L × W × H product dimensions
  • 3D coordinates[calcslive_qty_triplet values="(10, 20, 30)" unit="cm"] — for spatial specs or multi-axis ranges

All three values convert simultaneously, keeping dimensional specs coherent in any unit system.

Works With

Shortcodes and the Gutenberg block work inside any WordPress editor or plugin that renders standard shortcodes:

  • WooCommerce product tabs – Add unit-aware specs or calculators to any tab using plugins like Custom Product Tabs for WooCommerce or YITH WooCommerce Tab Manager
  • Elementor – Drop a Shortcode widget onto any product or landing page
  • Divi – Use a Code or Text module with the shortcode
  • WPBakery / Classic Editor – Paste shortcodes directly into any text area
  • Any shortcode-aware plugin – If it renders [shortcodes], CalcsLive shortcodes work inside it

Buying Calculations: Reduce Returns, Increase Confidence

Technical products often require customers to determine the right size and the right quantity before purchase. Without guidance, they guess—leading to returns, exchanges, and frustration.

Buying Calculations solve this by embedding pre-purchase calculators directly on product pages:

  • Sizing calculators – Help customers choose correct dimensions, capacity, or fit
  • Quantity calculators – Calculate how many bags, sheets, or units are needed

Create Calculators Without Coding

Traditional product calculators require custom development. CalcsLive changes this:

  • Create calculation logic using familiar technical data
  • Turn it into an interactive, unit-aware calculator
  • Embed on WordPress with a simple shortcode

From days of development to under one hour—no coding required.

Product teams, engineers, or office staff can create and deploy calculators themselves, shifting calculator creation from a development task to a content task.

How It Works

For unit-aware Quantities (free, no account):
1. Add to any page:
– Single quantity:
[calcslive_qty value=25.4 unit="mm"], value input without quote
[calcslive_qty value='25.4' unit="mm"], value input with ‘ ‘
[calcslive_qty value="25.4" unit="mm"], value input with ” “
– Quantity pair:
[calcslive_qty_pair values="10x20" unit="cm"] for 2D dimensions, or
[calcslive_qty_pair values="(10, 20)" unit="cm"] for coordinates/range
– Quantity triplet:
[calcslive_qty_triplet values="10x20x30" unit="cm"] for 3D dimensions, or
[calcslive_qty_triplet values="(10, 20, 30)" unit="cm"] for 3D coordinates
2. Visitors click to convert between compatible units

For embedded calculators:
1. Create your calculator on CalcsLive
2. Get your embed token and set it in the plugin settings
3. Grab article ID and add [calcslive id="YOUR_ID"] to your product page
4. Customers use the calculator interactively

Free Tier

Start free with CalcsLive:
* 2 embedded calculators
* 1 domain
* Full calculator functionality
* Unit-aware quantity shortcodes (unlimited, no account needed)

Get started free

Third-Party Service

This plugin relies on the CalcsLive external service to display interactive calculations. When an embed is rendered, your visitor’s browser loads content directly from CalcsLive via an iframe.

What is sent:

  • Your embed token and domain (included in the iframe URL)
  • The article ID you specify in the shortcode or block

No visitor data (such as IP addresses, cookies, or personal information) is collected or sent to CalcsLive by this plugin. The iframe loads in the visitor’s browser like any standard embedded content.

Quick Start

Unit-Aware Specs and Product Buying Calculators are two independent features. Use either one, or both.

A: Unit-Aware Specs (Free, No Account)

Use unit-aware quantity shortcodes anywhere shortcode insertion is supported — product descriptions, pages, posts, WooCommerce tabs, page builders:

[calcslive_qty value=25.4 unit="mm"] — single quantity  
[calcslive_qty_pair values="10x20" unit="cm"] — 2D dimensions or coordinates  
[calcslive_qty_triplet values="10x20x30" unit="cm"] — 3D dimensions or coordinates

Visitors click the unit dropdown to convert between compatible units. No API key. No external service. Fully client-side.

B: Embed Buying Calculators (Requires CalcsLive Account)

  1. Create your calculator at calcslive.com — no coding required
  2. Get your embed token (Settings CalcsLive in WordPress) and your article ID
  3. Embed anywhere with: [calcslive id="YOUR_ARTICLE_ID"] or use the CalcsLive Gutenberg block

Customers interact with the calculator live on your product page — inputs update in real-time.

Unit-aware Quantity Shortcodes

No API key needed. These shortcodes render interactive values that visitors can click to convert between units:

Single value:
[calcslive_qty value=25.4 unit=”mm”] (value input without quote)
[calcslive_qty value=’25.4′ unit=”mm”] (value input with ‘ ‘)
[calcslive_qty value=”25.4″ unit=”mm”] (value input with ” “)

Value pair — 2D dimensions:
[calcslive_qty_pair values=”10×20″ unit=”cm”]

Value pair — 2D coordinates or range:
[calcslive_qty_pair values=”(10, 20)” unit=”cm”]

Value triplet — 3D dimensions (L x W x H):
[calcslive_qty_triplet values=”10x20x30″ unit=”cm”]

Value triplet — 3D coordinates:
[calcslive_qty_triplet values=”(10, 20, 30)” unit=”cm”]

Optional attributes:

  • dp – Decimal places (default: 2)
  • show_unit_arrow – Show/hide unit dropdown arrow (default: true)

Getting Your Embed Token

  1. Sign up or log in at CalcsLive
  2. Go to Account API Keys
  3. Activate Ecommerce Embed service
  4. Add your WordPress domain to the allowed domains
  5. Copy the Embed Token to your WordPress settings

Demo Site

Unit-aware Quantity Shortcodes in Action

Live Product Page Examples

See live examples at cl.donwen.com:

Screenshots

Blocks

This plugin provides 1 block.

  • CalcsLive Article

Installation

  1. Upload the plugin files to /wp-content/plugins/calcslive-article-embed/, or install directly through the WordPress plugins screen.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress.

That’s it for unit-aware quantities — no account or API key needed. For embedded calculators, see the Quick Start below.

FAQ

How does this plugin help reduce product returns?

Product returns often happen because customers choose the wrong size or quantity — they guess, or they misread a spec in unfamiliar units. This plugin addresses that problem directly on the product page, before checkout. The unit-aware quantity shortcodes let customers instantly see specs in their preferred units (metric or imperial), so a customer in Europe and one in the US both understand the same product description. The embedded buying calculators go further: a customer entering their room dimensions gets an exact AC BTU recommendation, or a contractor entering square footage and depth gets an exact bag count for concrete. When customers are confident they have the right product, return rates and “wrong size” support tickets both go down.

How is this different from other WordPress calculator plugins?

Most WordPress calculator plugins (like Calculated Fields Form, WP Coder, or Calconic) are general-purpose form builders built around the idea of a monolithic calculator widget. CalcsLive is architecturally different in several ways:

Unit-awareness is native, not bolted on. Every variable in a CalcsLive calculation is a Unit-aware Quantity. Inputs and outputs automatically handle metric, imperial, and 67 other unit categories at the variable level — no separate conversion step, no approximation hacks. This is what makes every embedded value a Self-converting Quantity rather than a static number with a converter widget sitting next to it.

Decoupled, per-product architecture. Calculators live on the CalcsLive platform and are embedded independently into WordPress via shortcode or Gutenberg block. Each product or category can have its own dedicated calculator — an AC sizing calc for air conditioners, a bag count calc for concrete, a belt selection calc for power transmission. There is no shared monolithic calculator that every product must squeeze into. Add, change, or retire a calculator on any product without touching the others.

No-code creation, easy deployment. Calculators are created on CalcsLive using familiar technical notation — no custom programming required. Engineers, product managers, or office staff can build and update them. Deploying to WordPress is a single shortcode paste. The same calculator URL can also be shared standalone or embedded on non-WordPress sites via iframe.

Free unit-aware specs with no account. The [calcslive_qty], [calcslive_qty_pair], and [calcslive_qty_triplet] shortcodes give every product spec Unit Freedom at zero cost — no API key, no external service, entirely client-side.

What is the best way to add a sizing calculator to a WooCommerce product page?

The most common approach is to add a new product tab using a tab plugin like Custom Product Tabs for WooCommerce, then paste a CalcsLive shortcode into that tab’s content area. This keeps your product description clean while giving customers a dedicated “Sizing Calculator” or “How Much Do I Need?” tab. Alternatively, you can paste the shortcode directly into the product description or short description fields — it works anywhere WordPress renders shortcodes. For stores using Elementor or Divi for product layouts, use a Shortcode widget or Code module. Step-by-step instructions for WooCommerce tabs are in the WordPress Integration Guide.

Where do I get an embed token?

Sign up or log in at calcslive.com, then go to Account API Keys. Create a new key with service type “Website Embedding”, add your WordPress domain to the allowed domains list, and copy the token (it starts with cle_). Paste it into Settings CalcsLive in your WordPress dashboard. The token is only needed for embedded calculators — the unit-aware quantity shortcodes work without any account or token.

How do I find my calculator’s article ID?

Open your calculator on CalcsLive and look at the URL. The article ID is the alphanumeric code at the end — for example, in https://www.calcslive.com/view/3M7EJLZQ2-4N5, the article ID is 3M7EJLZQ2-4N5. Use that ID in your shortcode: [calcslive id="3M7EJLZQ2-4N5"]. You can also copy the embed shortcode directly from the CalcsLive article share menu.

Can I embed multiple calculators on one page?

Yes. Each [calcslive id="..."] shortcode embeds one calculator article as an independent iframe, so you can place as many as you need on a single page. Each article can itself contain multiple related calculations — for example, a pump sizing article might include flow rate, pressure drop, and power calculations all in one embed. Multiple independent embeds on the same page each count toward your plan’s embed page limit.

Does this work with page builders like Elementor?

Yes. Both the calculator embed and the unit-aware quantity shortcodes work in any page builder that renders standard WordPress shortcodes:

  • Elementor – Add a Shortcode widget and paste in [calcslive id="..."] or [calcslive_qty ...]
  • Divi – Use a Code module or Text module
  • WPBakery – Use the Classic Editor shortcode field or a Raw HTML element
  • Beaver Builder, Bricks, Oxygen – Use any HTML or shortcode module

The Gutenberg block is the easiest option if you use the default WordPress block editor — search “CalcsLive” in the block inserter and configure the calculator ID directly in the block settings panel.

Is this free?

The WordPress plugin itself is free and open source (GPLv2). The unit-aware quantity shortcodes ([calcslive_qty], [calcslive_qty_pair], [calcslive_qty_triplet]) are completely free with no account required — they run entirely in the visitor’s browser. Embedding interactive calculators requires a CalcsLive account; the free tier includes 2 embedded calculators on 1 domain. Paid plans add more embed pages, domains, and API access. See calcslive.com/pricing for current plan details.

Can customers enter their own values?

Yes — the embedded calculator is fully interactive. Customers type their own measurements into the input fields, choose their preferred units from the dropdown, and the calculated results update in real time. For example, a customer can enter their room dimensions in feet or meters, and the AC sizing calculator immediately shows the recommended BTU capacity. No page reload required. Customers can also switch the output units — the result recalculates automatically for the selected unit.

Do the unit-aware quantity shortcodes need an API key?

No. The [calcslive_qty], [calcslive_qty_pair], and [calcslive_qty_triplet] shortcodes work entirely in the visitor’s browser with no external service call. They use the bundled physical-quantity web component library, which is included in the plugin. Visitors see a clickable unit label next to each value and can switch to any compatible unit — for example, clicking “mm” on a dimension shows a dropdown with inches, cm, ft, and other length units. No CalcsLive account and no internet connection to CalcsLive are required for this feature to work.

What units are supported?

570+ units across 67 categories — the same full library used by CalcsLive. Categories include length, area, volume, mass, temperature, pressure, force, flow rate, energy, power, electrical (voltage, current, resistance), speed, torque, and many more. See the full Units Reference for the complete list. The unit-aware quantity shortcodes support all categories. For example: [calcslive_qty value="25.4" unit="mm"] lets visitors convert to inches, cm, feet, or any other length unit; [calcslive_qty value="1013" unit="hPa"] lets them convert atmospheric pressure to psi, bar, inHg, or Pa.

Where is the source code for the bundled JavaScript?

The pq.umd.js file is built from the open source physical-quantity npm package (MIT licensed). The source code is available on npm and the file itself is human-readable with version metadata in the banner comment. The physical-quantity library is also available as a standalone npm package for developers who want to use it outside of WordPress.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“From Unit Converter to Unit-Aware Quantities & Calculators” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.3.0

  • Migrated to the new public-safe Embed Token format (cle_xxx) — these tokens are designed to be safely embedded in public pages
  • Legacy embed_xxx tokens continue to work until 2026-08-31; replace yours with a cle_ token from Account API Keys before then
  • Renamed “API Key” “Embed Token” in settings UI to reflect the new token format
  • Added “Test Connection” button — validates your token server-side and shows plan tier and configured allowed domains

1.2.0

  • Updated bundled physical-quantity library to v1.3.0 — now shares the full CalcsLive unit library with 570+ units across 67 categories (see Units Reference)

1.1.5

  • Updated bundled physical-quantity library to v1.2.0
  • uc-qty-pair now correctly supports x-format (values="10x20") and tuple format (values="(10, 20)")
  • Updated shortcode examples in docs to use the two canonical formats

1.1.4

  • Added shortcode examples for qty, pair, and triplet in readme

1.1.3

  • Renamed plugin for better discoverability in WordPress directory
  • Improved readme with clearer feature descriptions and use cases

1.1.2

  • Added unit-aware quantity shortcodes: [calcslive_qty], [calcslive_qty_pair], [calcslive_qty_triplet]

1.1.1

  • Bundled physical-quantity web component library (v1.1.92)
  • PQ script loads only on pages using PQ shortcodes

1.0.1

  • Updated tested WordPress version to 6.9
  • Added third-party service disclosure for WP.org compliance
  • Added languages directory for i18n support

1.0.0

  • Initial release
  • Shortcode support: [calcslive id="..." width="..." height="..."]
  • Gutenberg block with live preview
  • Settings page for API key and default dimensions
  • Responsive iframe embedding