Unit Conversion lets visitors switch the ingredient amounts in a recipe between US customary (cups, spoons, ounces, pounds) and Metric (grams, milliliters) with one click. Write the recipe once in the system you cook with, and readers on the other side of the world get amounts they can measure.
You choose the default unit system of the recipe — the one you used when entering the ingredient amounts.
In the editor you fill in the amounts for the other system, either automatically with one click or by hand.
On the front end, visitors see a Metric / US switch in the Ingredients section and pick the system they prefer.
Both sets of amounts are stored with the recipe, so what your readers see is exactly what you approved in the editor.
Enable Unit Conversion in a recipe
Unit Conversion is enabled per recipe from the Recipe Card block settings.
Open the post with the Recipe Card and select the block.
In the block sidebar, open the Unit Conversion System panel.
Turn on Display Conversion Unit System.
Under Default Unit System, choose US customary or Metric — the system you used to write the ingredients.
If you leave Default Unit System on Select unit system, the panel shows a warning and the switch does not appear on the front end. Pick a system here, or set a plugin-wide default as described below.
Convert the ingredients
Once the feature is on, a switch appears at the top of the Ingredients section in the editor, labelled with your default system:
Flip the switch to see the alternative system (for a US recipe, Convert to Metric). Each ingredient now shows its original amount on the left and empty amount and unit fields for the other system.
Click Convert All Ingredients. Every amount is filled in: for Metric, solids become grams and liquids milliliters; for US, you get cups, spoons, ounces and pounds in the sizes a cook actually has (1/4, 1/3, 1/2 cup, tablespoons and teaspoons for small amounts).
Check the results and correct anything you like — the converted amount and unit are plain text fields, so you can type over any value, in any language.
Update the post.
Convert with AI is the alternative to Convert All Ingredients. It converts the whole list in one request and uses each ingredient’s name to choose a realistic weight or volume — useful for ingredients the standard converter does not recognise. Review the values it fills in before updating.
Teaspoon and tablespoon measures stay as they are in both systems (a metric teaspoon is the same spoon), and converted amounts snap to common cooking fractions, so you will not see results like “3/7 cup”.
Adjust a single ingredient
Next to each converted ingredient there is a convert button (⇄). Click it to open a short list of units for the target system — for Metric: grams, kilograms, milliliters, liters, tablespoons and teaspoons — and pick one to convert that ingredient to it, using the ingredient’s own density. Clear (show original) removes the conversion for that ingredient.
This is handy when the automatic result is not how you would measure it: 10 g of chia seeds reads better as teaspoons, and 45 g of oats as cups.
Enable Unit Conversion for all recipes
To have Unit Conversion turned on in every new recipe:
Go to Recipe Cards → Settings → General and scroll to the Unit Conversion section.
Check Enable Unit Conversion.
Choose the Unit System your recipes are written in. This becomes the default for new recipes and can still be changed per recipe in the block.
Click Save Changes.
Existing recipes keep their own setting; open and update them to change it. Converted amounts are never generated automatically — open each recipe and click Convert All Ingredients so you can check the values before they go live.
Tips for accurate conversions
Put the amount and unit in their own fields, not in the ingredient name. The converter reads the amount field; “2 cups flour” typed into the name cannot be converted. The same fields power Adjustable Servings.
Keep alternative measurements out of the name. A name such as flour (8.5 ounces or 240 grams) can make the converter pick up the “ounces” in the name instead of the cups in the amount field. Put such notes in the recipe Notes instead.
Amounts can be written as fractions the way people naturally write them — “1/4”, “1 1/2” or “½” — and are converted correctly.
Ingredients without a convertible unit, such as 2 eggs or 1 clove garlic, are left unchanged.
