Technical Docs
Ask or search…
Comment on page

Meal Plan

Which Meal Plan should I need to use?

Suggestic offers 3 different meal plan types to meet your needs. The meal plan you choose will give you the best dietary program according to your food preferences and goals.
Below find the characteristics of each meal plan for you to choose the one that fits your requirements.
OPTION 1: Custom Meal Plan
If you want to find a configuration that works best for your app and use cases without creating a meal plan, then the Custom Meal Plan fits for you.
OPTION 2: Meal Plan
If you want to create a 7-day meal plan with the possibility to add more days, use a custom format, and define a meal plan with specific settings such as mealtime preparation, meal distribution, number of ingredients, among others, then the Meal Plan fits for you.
OPTION 3: Simple Meal Plan
If you want to create a 7-day meal plan without adding any arguments, create custom attributes, update meal plan settings, among others, then the Simple Meal Plan fits for you.
OPTION 4: Meal Plan Templates
If you want to have control over your custom dietary requirements, you can choose one of the following meal plan templates option:
  • From days: Copy an existing meal plan which has a user assigned. All the restrictions, attributes, program assigned will be also applied to the template. For instance, a user can copy only a specific number of days from the meal plan.
  • From scratch: Create a meal plan manually. The user can define the number of days, recipes, and number of servings. For instance, it is possible to create either a 7-day meal plan or a 2-day meal plan.
  • Custom options: Create a meal plan in the same wah as if a customMealPlan is created. Therefore, calories, protein percentage, and the program to be assigned can be defined. .
The above options and their characteristics are well detailed in the following table. Choose the one that fits your requirements.
Simple Meal Plan
Meal Plan
Custom Meal Plan
Meal Plan Template - From Days
Meal Plan Template - From Scratch
Meal Plan Template - Custom
Create a 7-day meal plan
Request a Meal Plan to help find your ideal configuration
Define a specific number of meal plan days
Consider the user's goals
Overwrite pending days in your meal plan
Remove a meal plan
Assign a user to a meal plan
Create a meal plan without any argument
Prevent user from generating a new meal plan
Update meal plan settings
Setup user's food restrictions
Simple Meal Plan
Meal Plan
Custom Meal Plan
Meal Plan Template - From days
Meal Plan Template - From Scratch
Meal Plan Template - Custom
Include 2 random recipes
Sets an upper kcal limit per meal
Define a maximum number of servings per meal
Define a maximum serving weight
Define Minimum serving weight
Define meals distribution
Define maximum quantity of ingredients per meal
Define time preparation per meal
Set the user program
Create custom attributes
Define a margin of error
Define the percentage of omega-3
Define the percent of Fat
Define the percent of Protein
Define the percent of Carbs
Define the total calories per day
Define filters to create a meal pan with caloric range and tags per each meal time
Generate a meal plan based on a meal plan template ID
Add days from the meal plan template to your current meal plan
Define the variety of the recipes

I have an error generating the meal plan, what can I do?

There are many factors to consider when creating and generating a meal plan. If the settings, restrictions, macro goals, or any other meal plan setting is not well defined, the following error may appear: Couldn't generate a meal plan with the current settings.
Refer to this documentation to see how are the common scenarios in which this error appears and how to solve it.

What is the difference between recipe.numberOfServings with meal.numOfServings?

  • meal.numOfServings is the assigned number of servings by the meal plan.
  • recipe.numberOfServings is the original recipe number of servings.
For more information, check the Meal Plan documentation

How can I generate a meal plan for more than 7 days?

The mealPlan query usually generates a 7-day meal plan. When these 7 days are reached, there are two options:
  1. 1.
    Generate a new set of 7 days using generateMealPlan with addDays: true (the new day 1 will come after the "current" day 7)
  2. 2.
    Repeat the previous 7 days using generateMealPlan with repeat: "date" (same behavior but with the same meals as before)

Is it possible to restrict food in a meal plan?

Yes, you can get the list of food restrictions, and then use the profileRestrictionsUpdate mutation to update a user's food restrictions.

How can I generate a meal plan based on a selected program? i.e Vegan or Keto

Execute the following API methods in the order detailed below:
  1. 1.
    Use the program query to check for available programs, copy the ID of the desired program you want to use in your meal plan.
  2. 2.
    Set the user program by executing the updateUserProgram mutation
  3. 3.
    Generate your meal plan, you can use either the generateMealPlan mutation or the customMealPlan mutation

How can I get suggestions as to whether the food choice fits my meal plan?

You can use the Adherence Score which represents how good of a match (higher is better) is a particular food recommendation with the user's program and profile.

How can I log food nutrient information for a specific food?

You can log the nutrients for a specific food by using the createMealLog mutation and within it the MealType parameter.

Are there any queries to get dessert recipes?

Yes, you can execute the recipeSearch,recipesByTag or recipesByMealTime