Getting started

How to Enable Unit Conversion for Ingredients

The Unit Conversion feature allows visitors to convert ingredient quantities between US Customary and Metric units directly in your recipes. This feature is handy for international audiences and improves overall usability.

Unit Conversion is a premium feature, available only with the Professional or Business license.
See more: How can I upgrade my license?


How Unit Conversion Works

When Unit Conversion is enabled:

  • You choose a primary unit system for the recipe.
  • The plugin automatically calculates equivalent values for the alternative unit system.
  • Visitors can switch between unit systems on the front end.

All conversions are handled automatically using an integrated conversion API.


Enable Unit Conversion In A Recipe

Unit Conversion is enabled per recipe from the Recipe Card block settings.

1. Open a post containing a Recipe Card.

2. Select the Recipe Card block.

3. In the right sidebar, open Unit Conversion System.

4. Enable the Display Conversion Unit System toggle.

5. Choose the primary unit system used when writing the recipe (US Customary or Metric).

    The primary unit system is the one you use when entering ingredient amounts.

    After enabling Unit Conversion, you can configure how each ingredient is converted.

    6. Switch to the alternative unit system in the Recipe Card.

    7. For each ingredient, choose the unit you want it converted to.

    8. Repeat for all ingredients that should support conversion.

    9. Save or update the recipe.

    Note: Clicking on Convert All ingredients will automatically convert the default units to the alternative ones. Feel free to make manual adjustments to each ingredient if necessary.

      The plugin will automatically calculate the correct converted amounts based on the primary unit system.


      Enable Unit Conversion For All Recipes

      If you want Unit Conversion to be enabled by default in all new recipes, you can turn it on globally.

      1. Go to Recipe Cards โ†’ Settingsย โ†’ย General.

      2. Open theย Adjustable Servingsย tab and check theย Enable Adjustable Servingsย field.

      3. Save the settings by clickingย Save Changes.

        Once enabled, Unit Conversion will be active automatically in all newly created recipes.
        Existing recipes may require opening and saving the recipe again to apply the setting.

        Last updated on January 20, 2026