Platform 2 Guide — This article applies to the new platform. Looking for classic platform docs? Browse the Platform 1 collection.
Why: Understanding these key rules helps you manage your app effectively, ensuring your members have the right access to content and a smooth experience with subscriptions, meal plans, and nutrition.
Navigate: This is a reference article covering how the platform behaves behind the scenes.
Content and Access
Content Visibility: Content without access level restrictions is public and viewable by anyone. If you want to restrict access, you can set specific access levels for your content.
Access Levels: Access levels use OR logic, meaning content can require any of multiple access levels for visibility. If a member has at least one of the required access levels, they can view the content.
Admin Access: As an admin, you always have access to everything in your app, regardless of the access level settings.
Publishing Content: Content must be published to be accessible to non-admins. Ensure your content has a publish date that is current or in the past.
Content Grants: Manual content grants take priority over visibility modes and access level requirements. If a member has a direct content grant, they can access that content regardless of other restrictions.
Subscriptions
Active Subscriptions: Members can only have one active subscription per subscription group. If they try to purchase another, they will be redirected to manage their existing subscription.
Immutable Offers: Once an offer is synced with payments, the price and billing interval cannot be changed. Make sure to finalize your offer details before syncing.
Meal Plans and Shopping Lists
Leftovers: Ingredients from recipes marked as leftovers in a meal plan are excluded from shopping lists, as they are already accounted for in the meal session.
Ingredient Combination: Ingredients in shopping lists are combined if they share the same ingredient and aisle. This helps streamline your members' shopping experience.
Component Ingredients: Ingredients from component recipes are automatically included in shopping lists unless the recipe is consumed as a leftover.
Nutrition
Automatic Calculation: Nutrition values are calculated automatically from the ingredients in your recipes. This ensures accurate nutrition information for your members.
Override Options: You can override nutrition values at the recipe level. If you set an override, the ingredient-level nutrition will be ignored.
Component Recipes: Nutrition from component recipes is included in the calculations, but only one level deep. Nested components are not included.
Yield-Based Recipes: For yield-based recipes, nutrition is calculated per unit of yield instead of per serving. This is useful for recipes where the output is measured by weight or volume.
Recipes and Output Modes
Serving Modes: Recipes can be set to either servings mode or yield mode. In servings mode, nutrition and scaling are based on the number of servings. In yield mode, they are based on the physical output.
Yield Mode Details: When using yield mode, the recipe is defined by a yield amount and unit (e.g., grams or liters). This choice affects how nutrition, scaling, and shopping lists are calculated.
Members
Private Content: Member-created recipes and meal plans are private and only visible to the member who created them. This ensures their content remains confidential.
Nutrition Editing: Members cannot edit nutrition values directly; they see calculated values as read-only. This maintains the integrity of the nutrition information.
No Notifications: Member-created content does not trigger notifications when published. This helps reduce unnecessary alerts for other members.