Platform 2 Guide — This article applies to the new platform. Looking for classic platform docs? Browse the Platform 1 collection.
Why: Allow your members to personalize their cooking experience by customizing recipe ingredients. This feature helps them cater recipes to their tastes and dietary needs, enhancing their overall satisfaction with your app.
Navigate: App Station > Settings > Access Levels > [level] > Member Permissions > Customize recipes
Quick Start
Go to the Access Levels section in App Station.
Select the access level you want to modify.
Ensure the canModifyRecipes permission is enabled.
Instruct members to open a recipe and click the Customize button.
Members can swap, remove, or include optional ingredients as needed.
Overview of Ingredient Customization
Members can customize recipe ingredients in several ways:
Deleting Ingredients: Members can hide ingredients they don’t want to see, such as those they are allergic to or dislike.
Swapping Ingredients: Members can replace an ingredient with another from the ingredient library.
Including Optional Ingredients: Members can opt in to optional ingredients marked by the admin, which will then be included in shopping lists and nutrition calculations.
Key Features of Modifications
User-Specific: Each member's modifications are unique to their account.
Recipe-Specific: Changes apply only to the selected recipe.
Persistent: Modifications are saved and applied consistently.
Reversible: Members can reset their changes to the original recipe at any time.
Optional Ingredients
Optional ingredients are displayed dimmed, with a clickable + Optional toggle chip. When included, the chip changes to ✓ Included. Here’s how they behave:
Shopping Lists: Optional ingredients are excluded unless included.
Nutrition Calculations: They are not included until the member opts in.
Cooking Mode: Only included optional ingredients are shown.
Members can toggle the optional ingredients directly if they have the necessary permissions. If they lack permission, they will see an upgrade prompt.
Permissions
To allow members to customize recipe ingredients, ensure they have the canModifyRecipes permission enabled in their access level. Admins always have this permission.
If a member does not have permission:
The Customize button will be hidden.
They will receive a prompt when attempting to access customization features.
Resetting Modifications
Members can reset their ingredient modifications at any time, which will clear all changes, including any included optional ingredients.
Best Practices for Ingredient Customization
Encourage Swapping Over Deleting: If a member tries to delete an ingredient that is used in the recipe instructions, prompt them with a warning and suggest swapping instead.
Auto-Save Changes: Implement auto-saving with a debounce feature to minimize excessive API calls when members make modifications.
Loading Indicators: Display loading indicators when fetching or saving modifications to enhance user experience.