Platform 2 Guide — This article applies to the new platform. Looking for classic platform docs? Browse the Platform 1 collection.
Why: Streamline your recipe development by effectively managing ingredients. Customize app-wide defaults, create specific ingredients for your app, and ensure accurate nutrition calculations for your members.
Navigate: App Station > Settings > Content Settings > Ingredients
Quick Start
Go to the Ingredients page in App Station.
Click Add Ingredient to create a custom ingredient.
Fill in the ingredient details, including name, serving size, and nutrition values.
Use the Bulk Import feature to upload ingredients from an Excel file.
Manage existing ingredients by editing or replacing them in recipes.
Understanding Ingredients
Ingredients in your app can be categorized into two types:
App Default Ingredients: These are pre-populated ingredients available across all apps. They can be customized for your app through tenant overrides.
Custom Ingredients: These are specific to your app and can only be created by users with ADMIN, OWNER, or SUPERADMIN roles. Members cannot create new ingredients; they can only use existing ones in their recipes.
Who Can Create Ingredients
Only users with ADMIN, OWNER, or SUPERADMIN roles can add new ingredients to the ingredient library. Members can attach existing library ingredients to their own recipes or recipe customizations but cannot create new ones.
Note: The Import-from-URL feature is currently disabled for all roles.
Serving Size
When creating or editing a custom ingredient, you can specify the serving size, which determines the basis for its nutritional values. The default serving size is 100 grams, but you can change it to any unit available in the system, including ounces, cups, and tablespoons.
The platform automatically converts between units when calculating recipe nutrition, ensuring accurate values regardless of the measurement system your members prefer.
Ingredient Editor Layout
The full-page ingredient editor uses a 5-tab layout:
Basics: Contains the ingredient name, aisle, and preferred toggle.
Nutrition: Displays serving size and nutritional values.
Density: Shows density (g/mL) and wet/dry classification for volume-to-gram conversion.
Portions: Allows entry of per-count portion sizes (e.g., '1 medium banana = 118 g').
Allergens: Lists allergen tags.
Each tab shows a dot indicator when that section has an active override. The active tab is saved in the URL, allowing you to bookmark or share a specific section.
Portion Overrides
Admins can add per-count portion entries to any ingredient, including app-default library ingredients. For app-default ingredients, portions are stored as a tenant override, meaning they do not modify the shared library.
Bulk Importing Ingredients via Excel
You can bulk import ingredients using an Excel template:
Download the pre-filled Excel template from App Station > Settings > Content Settings > Ingredients.
Fill in the spreadsheet with your ingredient data.
Upload the completed file back to create all ingredients at once. Duplicates will be automatically skipped.
Bulk Replacing an Ingredient Across Recipes
From the Content Library, you can filter recipes by ingredient, select multiple recipes, and use the Actions > Ingredients > Replace Ingredient option to swap one ingredient for another across all selected recipes. This action updates ingredient references, recalculates nutrition, and refreshes shopping lists automatically.
Uncurated Ingredients
Ingredients that are auto-created during platform migrations or bulk imports are marked as 'uncurated' and hidden from member-facing pickers and autocompletes by default. Admins can review these ingredients in two places:
Migration Review Tool: For P1 to P2 migrations.
Import Ingredient Review Tab: Located on the Ingredients page in App Station.
Approved mappings become sticky rules for future imports, ensuring consistency. You can also toggle the visibility of uncurated ingredients directly on the Ingredients Settings page.
Conclusion
By effectively managing ingredients, you can enhance the quality and accuracy of your recipes, ensuring a better experience for your members. For more detailed information on specific features, refer to the related articles below.