🔧 ConvertXpress Widget

Embed a powerful unit converter on your website in minutes

📦 Quick Installation

Get started with the ConvertXpress widget in just 2 simple steps:

Add the HTML

Place this div where you want the widget to appear on your page:

Include the Script

Add the widget script before the closing </body> tag:

⚙️ Customization Options

Customize your widget with these data attributes:

Available Categories

Limit which categories are available for selection

Format: Comma-separated list of category names

Theme

Match your website's design

Options: light, dark

Category Switcher

Show/hide category selection buttons

Options: true, false

Example with Options:

<div data-convertxpress-widget
    data-category="weight"
    data-categories="length,weight,volume"
    data-theme="dark"
    data-show-categories="true">
</div>

🚀 JavaScript API

For advanced use cases, initialize widgets programmatically:

<div id="my-converter"></div>

<script src="/convertxpress-widget.min.js"></script>
<script>
  // Initialize widget with custom options
  ConvertXpressWidget.init('my-converter', {
    category: 'volume',
    categories: ['length', 'temperature'],
    theme: 'light',
    showCategories: true
  });
  
  // Use conversion functions directly
  const result = ConvertXpressWidget.convert('length', 'm', 'ft', 10);
  console.log('10 meters =', ConvertXpressWidget.formatNumber(result), 'feet');
</script>

📥 Download & Self-Host

📄 Download JS (Development)

💡 Pro Tip: The widget is only ~16KB minified and has no external dependencies. It works great with any website or framework!

Self-Hosting Instructions:

Download the widget file
Upload it to your website's assets folder
Update the script src to point to your hosted file:

🎯 Use Cases

🏗️ Construction Sites

Help visitors convert between metric and imperial measurements for building materials and dimensions.

🍳 Recipe Blogs

Allow readers to convert cooking measurements, temperatures, and volumes for international recipes.

🏃‍♂️ Fitness Apps

Convert weights, distances, and time measurements for workout tracking and goal setting.

🌍 Travel Websites

Help travelers understand local measurements, temperatures, and distances in familiar units.

📚 Educational Sites

Provide students with an interactive tool to learn and practice unit conversions.

🛒 E-commerce

Help customers understand product dimensions, weights, and specifications in their preferred units.

❓ FAQ

Is the widget free to use?

Yes! The ConvertXpress widget is completely free to embed on your website. It includes a small "Powered by ConvertXpress.com" link that helps support the project.

Does it work with my CMS/framework?

Absolutely! The widget works with any website - WordPress, Shopify, React, Vue, plain HTML, or any other platform that supports custom HTML and JavaScript.

Can I customize the appearance?

The widget includes light and dark themes and is designed to blend well with most websites. For advanced customization, you can override the CSS styles.

How accurate are the conversions?

All conversions use precise mathematical formulas and are accurate to 8 significant digits. The same conversion engine powers ConvertXpress.com.

Does it require an internet connection?

Once loaded, the widget works completely offline. All conversion calculations happen in the browser - no API calls required.