What actions are available for Shortcuts?
In the Shortcuts app, you'll find a robust set of 44 actions for Foodnoms within 8 categories: Foodnoms, Food, Goals, Library, Log, Meal Types, Meals, and Recipes.
Here's a full list of the actions and their descriptions:
Action | Category | Description |
---|---|---|
Open Foodnoms | - | Opens into the Foodnoms app to a specific view. Options include Food Log, Library, Goals, and Settings. When opening to the Food Log, includes an option to select a date, including presets for Today and Yesterday. |
Open Foodnoms File | - | Opens the contents of a Foodnoms file and passes the contained data as a result. |
Search | - | Navigates the user to search results for the specified criteria. Text Search criteria used when searching in Foodnoms. Scope Whether to search for generic foods, branded items, items in your library, or all of the above. |
Create Food | Food | Creates a new food using the specified nutrients. Name The name of the new food. Brand The brand owner of the food, if applicable. Barcode The GTIN/UPC barcode of the food, if applicable. Serving Size The household serving size of the food. "Household serving size" refers to the portion of the serving size listed on a U.S. nutrition label that is outside the parentheses, typically stated in common household measures like "1 cup," "2 slices," or "1 bar." This is distinct from the gram weight or metric measure, which is typically listed in parentheses. Serving Metric Unit The unit of measurement for the serving size in metric terms. This is typically listed in parentheses on U.S. nutrition labels and includes units like grams (g) and milliliters (ml). Serving Metric Weight/Volume The numeric amount of the serving size in terms of the specified metric unit. This value corresponds to the measurement listed in parentheses on U.S. nutrition labels, such as "240" for 240 ml. Values Represent Specifies whether the numerical nutritional values correspond to the serving size or are normalized per 100g/ml. Typically in the U.S., nutritional values correspond to the serving size. Immediately Save Whether to save the created food to your food library, or pass it as output. |
Copy Logged Food | Food | Copy logged food from a particular day, optionally filtering by meal type, to another day. Source Date The source date of the food entries to copy. Defaults to Yesterday. Destination Date The destination date of the food entries to copy. Defaults to Today. Meal Type The meal type to filter by when copying food entries. Confirm Before Copying Whether or not to copy the food entries without confirmation. Defaults to true. |
Delete Logged Food | Food | Deletes food entries from your food log. Delete Immediately Whether or not to delete food entries without confirmation. |
Duplicate Food | Food | Duplicates a food, allowing you to make changes without impacting the original. Immediately Save Whether to save the duplicated food to your food library, or pass it as output. |
Edit Food | Food | Modifies a specific field of a food. Food The field to edit. |
Find Food | Food | Finds or filters food items. Note: By default, this action returns food items from your library. To use food you have previously logged, first run the Get Logged Food action, then pass its output into this action. Sort By Optionally, what to sort the food by. Limit Whether or not to limit the number of food retrieved. Get The maximum number of food to limit by. Result The food that matches the criteria. |
Get Drinks | Food | Retrieves the list of preset drinks from Foodnoms. Allows you to select All Drinks, one, or multiple drinks to pass out as a result. |
Get Logged Food | Food | Retrieves logged food from a particular day. Date The date of the food entries to get. Options include presets for Yesterday, Today, On Date, This Week Last Week, and Between Dates. Meal Type The type of meal to get logged food from. Options include Any Meal Type, Current Meal Type, Other, and the Meal Types specified in Settings > Meal Types. |
Get Smart Suggestions | Food | Gets smart suggestions for a particular day and meal type. Note: Smart Suggestions are determined by a mix of of factors, including which day of week and food logged on that same day of the week. For example, when run on a Monday, gets smart suggestions for food logged on Mondays. Meal Type The meal type to get smart suggestions for. Options include Current Meal Type and the Meal Types specified in Settings > Meal Types. |
Open Food | Food | Opens a food item in the app to the Edit Food view, where you can view the item summary, plus manually change item details, adjust Nutrients values, and share or delete the food. Food The food to open. |
Scan Barcode | Food | Scans a barcode from an image passed as input, then looks up the result in your library and the Foodnoms Database. Image The image with the barcode to be scanned. Result (Food) Food from your library or the Foodnoms Database that matches the scanned barcode. Note: If no results are found, action passes nothing as output. |
Search Foodnoms Database | Food | Returns a list of food using a query for any food or brand. Text The text to search for. Scope Whether to search for generic foods, branded foods, or both. Limit The maximum amount of results to be returned. Must be less than or equal to 30. Note: You can increase the limit up to 30, but repeated use may result in rate limiting. |
Add New Goal | Goals | Creates a goal to track your progress over time. Includes options to specify a goal type, tracking mode, and detailed parameters based on the selected mode. Type The type of goal to create. Options include Calories/Energy, macronutrients, other nutrients, and fasting. Overwrite If Goal Exists Whether or not to add the new goal if one already exists of the same type. If toggled off, will error if existing goal is found. |
Change Goal | Goals | Modifies a specific field of a goal. Options include Mode, Adjust Using Active Energy Burned, Relative to Calorie Goal, Resting Energy Calculation, Age, Weight, Height, resting metabolic rate (RMR), sex, active energy, weekly weight goal, daily minimum, and one-day exception. Goal The type of goal to modify. One-Day Exception Whether or not to have these changes only be in effect for a single day, or from now on. |
Check Goal Progress | Goals | Summarizes the specified goal's progress by evaluating logged food against the goal's date, then returns a rich result showing the progress. Note: See the description for Change Goal to see the type of data available for each goal. Goal The goal to check. Show When Run Whether to show the rich snippet of the goal progress, or to simply pass the goal as a result. |
Delete Goal | Goals | Permanently delete a goal and removes all history of goal settings. Note: Deleting a goal does not remove consumption records, as amounts consumed are logged separately within your food entries. Goal The goal to delete. Delete Immediately Whether or not to delete the goal without confirmation. If toggled on, prompts twice to ask if you are really sure. |
Find Goals | Goals | Retrieves a list of goals according to the specified criteria. Find The goals to find. Defaults to All Goals. When set with the result of another action, changes to Filter. Add Filter Optionally, the criteria to filter by. Includes all types of data available for goals. If multiple filters are added, the action updates to include All or Any of the following are true. Note: You can use Find multiple times and Filter the results of one through another. Sort By Optionally, what to sort the goals by. Limit Whether or not to limit the number of goals retrieved. Get The maximum number of goals to limit by. Result The goals that matches the criteria. |
Get Goal Types | Goals | Gets a list of the types of goals available to set. Retrieves all, one, or multiple types of possible goals. Goal Type The type of goal to get, whether All Goal Types or a specific goal type. Type If set to Goal Type, the specific goal type to get. |
Get Goals | Goals | Gets a list of your goals that have already been set. Retrieves all, one, or multiple types of your set goals. Goal Type The type of your goal to get, whether All Goals, or a specific Goal. Type If set to Goal, the specific goal type to get. Date The date to get the goal from. Options include Today, Yesterday, and On Date, where you can specify a date. |
Open Goal | Goals | Opens a goal in the app, where you can check visualizations for how much you've consumed against your goal amount across various periods. Goal The goal to open. |
Get Library Items | Library | Gets a list of items from your food library, Includes the option to select all, one, or multiple items of each type to pass as a result. Type The type of item to get. Options include All Food, All Recipes, All Meals, or a specific food, recipe, or meal. Item If set to Food, Recipe, or Meal, the specific food, recipe, or meal to get. Note: Both Meals and Recipes contain a Food parameter, which means they can used with Food actions. |
Save To Library | Library | Saves a food, recipe, or meal to your library as an item. Type The type of item to save, whether it's Food, Recipe, or Meal. Overwrite If Item with Same Name Exists Whether or not to overwrite the item if another item exists in your library with the same name. Defaults to off, which means it will create a duplicate item (rather than destroying your existing item). |
Search Food Library | Library | Returns a list of food, recipes, and meals that match a query. Text The text to search for. Scope Whether to search for food, recipes, meals, or All content in your library. Open When Run Whether or not to open to search results for your query in the app, or return a list of results |
Ask Foodnoms AI | Log | Submits a query to FoodNoms AI, which returns a list of food items based on your input. Includes the ability to add text, an image, or both. Note: Foodnoms AI usage is rate limited. Text A natural-language description of the food items to log. Image A photo of the food items to log. Mode The mode to use when querying Foodnoms AI. Options include Estimate Mode and Database Mode. Date The date and time of the food entry to create. Meal Type The meal type associated with the food entry. Options include Current Meal Type and Meal Types specified in Foodnoms > Settings > Meal Types. Accuracy The estimate for the accuracy of nutrients for this food entry. Options include Accurate, Approximate, and estimate. Log Immediately Whether to log the generated items immediately, or simply pass them as a result. |
Log | Log | Logs a food, recipe, meal, favorite, or drink as a food entry in your Food Log. Type The type of item to log, whether Food, Recipe, Meal, Favorite, or Drink. Food/Recipe/Meal/Favorite/Drink For a specified Type, the item to log. Date The date and time for the food entry. Time Whether or not to log with time. Meal Type The meal type for the food entry. Defaults to Current Meal Type, which uses the corresponding meal type as defined in Settings > Meal Type. Use Last Portion Size Whether to use the portion size from the most recent entry for this item. If no previous entry exists, the default portion size is used. Quantity The amount of food consumed, as expressed in the specified Unit. Unit The measurement unit for the food entry. Accuracy The estimated for the accuracy of nutrients for the food entry. Options include Accurate (+/- 0%), Approximate (+/- 10%) and Estimate (+/- 30%). |
Log Quick Entry | Log | Creates a quick entry that logs nutritional amounts consumed, without an existing food item. Name The name of the quick entry. Defaults to "Quick Entry" if none is given. Date The date and time of the entry. Meal Type The meal type associated with the entry. Accuracy The estimate for the accuracy of nutrients for this food entry. Options include Accurate, Approximate, and estimate. |
Open Foodnoms AI | Log | Opens the FoodNoms AI view, which can be used to submit a query and log the generated food items. Includes the ability to pass text, an image, or both as input, as well as specify the mode, all of which are activated when Foodnoms AI is opened. Text A natural-language description of the food items to log. Image A photo of the food items to log. Mode The mode to use when querying Foodnoms AI. Options include Estimate Mode and Database Mode. |
Open Log Food Screen | Log | Opens to the Log Food screen, the main menu for logging, letting you manually create an entry using the Foodnoms interface for Search, Favorites, Smart Suggestions, and options for Create, Library, Scan, Drinks, and AI. |
Open Scanner | Log | Opens the Barcode Scanner or the Foodnoms AI scanner, letting you quickly create an entry for food using your device's camera. Scanner The type of scanner to open. Options include Barcode Scanner and Foodnoms AI Scanner. |
Find Meal Types | Meal Types | Retrieves a list of meals types, as specified in Foodnoms' Settings under Meal Types. Sort By Optionally, what to sort the meal types by. Limit Whether or not to limit the number of meal types retrieved. Get The maximum number of meal types to limit by. Result The meal types that match the criteria. |
Get Meal Types | Meal Types | Retrieves available Meal Types, as specified in Foodnoms' Settings under Meal Types. Includes options to select all, one, or multiple meal types. Result (Meal Types) The specified meal types. |
Create Meal | Meals | Creates a new meal using the food passed as input. Name The name of the new meal. Food The food items that make up the meal. Immediately Save Whether to save the created meal to your food library, or pass it as output. |
Duplicate Meal | Meals | Duplicates a meal, allowing you to make changes without impacting the original. Immediately Save Whether to save the duplicated meal to your food library, or pass it as a result. |
Edit Meal | Meals | Modifies a specific field of a meal. Meal The meal to edit. Detail The specific field of the meal to be modified. Options include Name and Food. Value The value of the specific field to be modified. Value changes according to the type of field. |
Find Meal | Meals | Retrieves a list of meals from your food library according to the specified criteria. Find The meals to find. Defaults to All Meals. When set with the result of another action, changes to Filter. Add Filter Optionally, the criteria to filter by. Includes all types of data available for meals. If multiple filters are added, the action updates to include All or Any of the following are true. Note: You can use Find multiple times and Filter the results of one through another. Sort By Optionally, what to sort the meals by. Limit Whether or not to limit the number of meals retrieved. Get The maximum number of meals to limit by. |
Open Meal | Meals | Opens a meal in the app to the Edit Meal view, where you can view the summary of food items in the meal, plus manually change the meal name, add or remove food items, and share or delete the food. Meal The meal to open. |
Create Recipe | Recipes | Creates a new recipe using the ingredients passed as input. Name The name of the new meal. Food The ingredients that are used to make the recipe. Number of Servings How many servings the recipe makes. Total Weight (g) The total mass of the prepared food, expressed as grams. Immediately Save Whether to save the created meal to your food library, or pass it as a result. |
Duplicate Recipe | Recipes | Duplicates a recipe, allowing you to make changes without impacting the original. Immediately Save Whether to save the duplicated recipe to your food library, or pass it as a result. |
Edit Recipe | Recipes | Modifies a specific field of a recipe. Recipe The meal to edit. Detail The specific field of the recipe to be modified. Options include Name, Food, Number of Servings, Total Wight (g), URL, and Notes. Value The value of the specific field to be modified. Value changes according to the type of field. |
Find Recipes | Recipes | Retrieves a list of recipes from your food library according to the specified criteria. Find The recipes to find. Defaults to All Recipes. When set with the result of another action, changes to Filter. Add Filter Optionally, the criteria to filter by. Includes all types of data available for recipes. If multiple filters are added, the action updates to include All or Any of the following are true. Note: You can use Find multiple times and Filter the results of one through another. Sort By Optionally, what to sort the recipes by. Limit Whether or not to limit the number of recipes retrieved. Get The maximum number of recipes to limit by. |
Open Recipe | Recipes | Opens a recipe in the app to the Edit Recipe view, where you can view the recipe summary and ingredients in the recipe, manually change the recipe name, number of servings, and total weight, add or remove ingredients, update the URL and notes, and share or delete the food. Recipe The recipe to open. |