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 to their preferences and dietary needs, enhancing their engagement with your content.
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.
Enable the canModifyRecipes permission for members.
Inform members about how to customize ingredients in recipes.
Encourage them to explore optional ingredients for a tailored experience.
Overview of Ingredient Customization
Members can personalize recipes in several ways without altering the original recipe created by you, the admin:
Deleting Ingredients: Members can hide ingredients from their view, such as those they are allergic to or prefer not to use.
Swapping Ingredients: They can replace an ingredient with another from the library.
Modifying Amounts: Members can change the quantities or units of ingredients.
Including Optional Ingredients: Members can opt to include ingredients marked as optional, which will then contribute to their shopping lists and nutrition calculations.
Key Features of Customizations
User-specific: Each member's modifications are unique to them.
Recipe-specific: Changes apply only to the individual recipe.
Persistent: Modifications are saved and applied across sessions.
Reversible: Members can reset their changes to the original recipe at any time.
Note: Members need the canModifyRecipes permission on their access level to customize ingredients. Admins always have access to all features and cannot make member-specific selections.
Optional Ingredients
Optional ingredients are marked by you in the recipe. Here’s how they work:
They appear dimmed in the ingredient list with a "+ Optional" toggle chip.
When included, the chip changes to "✓ Included," and the ingredient is fully visible.
Optional ingredients do not show up in shopping lists or affect calculated nutrition until they are included by the member.
Members can toggle the optional ingredients directly. If a member does not have the necessary permissions, they will see an upgrade prompt instead of the toggle.
Resetting Modifications
Members can reset their ingredient modifications at any time, which will clear all changes, including any optional ingredients they have included.
Permissions
To allow members to customize recipe ingredients, ensure the following:
The canModifyRecipes permission must be enabled for the member's access level.
By default, new access levels have this permission enabled, but you can disable it in the App Station.
When a member lacks permission to customize recipes:
The Customize button will be hidden on recipe ingredient lists.
Any attempts to save or delete modifications will result in a 403 error.
Encourage your members to explore these features to enhance their cooking experience and engagement with your app!