Add

You can add a recipe by clicking the blue Add Recipe in the middle of the application bar.

Adding Recipes

You will be presented with four different ways of adding a recipe to your collection.

• Manual
• Scan
• Website
• Import

Manual

The simplest method of inputting a recipe involves completing a form that outlines your dish.

The following fields, indicated with an asterisk (*), are mandatory:

• Title
• Ingredients
• Instructions

The following presents the default values of empty fields after submitting:

• Media → Default sushi image
• Category → “uncategorized”
• Servings → 1
• Source → “Unknown”
• Keywords → none
• Time → 15m (prep), 30m (cooking)
• Description → empty
• Tools → none

You might find these shortcuts useful if you are filling the form from your computer.

You can also reorder the ingredients and the instructions by dragging the arrow vertically.

Scan

You can upload an image or a scan of a handwritten or printed recipe to add it to your collection. This option is useful for digitizing your and your family’s paper recipes.

To do so, click the Upload button and select a document on your computer.

You can upload files in the following formats:

• Images (JPEG/JPG, PNG, BMP, HEIF)
• PDF
• TIFF

Website

You can import any recipe from the supported websites. To do so, click the Fetch button, paste the recipe’s URL or URLs, each on a new line, and click Submit. A notification will appear when the operation finished.

Its action button performs an action based on the outcome. When you imported one URL and the operation succeeds, the action will redirect you to the recipe. Otherwise, you will be redirected to the latest report.

To view all supported websites, please click on the supported word. You can scrape a website not in the supported list, but recipe extraction may fail. Please open an issue on GitHub if it does.

Import

You can import recipes in the following formats:

• .json: If they adhere to the Recipe schema standard
• .mxp: Exported recipes from MasterCook
• .paprikarecipes: Exported recipes from Paprika in the Paprika Recipe Format
• .txt
• .zip

You can upload either a single file or a zip archive containing multiple recipes. The recipes in a zip file may be organized by folder. Each folder can contain the recipe’s .json file. All other files in a folder will be ignored during processing.

You may also upload exported recipes from the following applications:

• AccuChef
• ChefTap
• Crouton
• Easy Recipe Deluxe
• Kalorio
• MasterCook
• Paprika
• Recipe Keeper
• RecipeSage
• Saffron

Please refer to the integrations page for application-specific instructions.

Recipya Bookmarklet

The Recipya bookmarklet allows a user to run a JavaScript snippet from their browser that extracts a recipe from a webpage.

It’s for websites that both:

• can’t be scraped via a server request, i.e. have something like captcha or bot detection
• that have json+ld recipe script snippets on their page

To get the bookmarklet:

1. Access /recipes/add
2. Bookmark the Recipya Bookmarklet link in the Import card.

To use it:

1. Open a recipe webpage, e.g. double banana nut bread
2. Click the bookmarklet
3. A JSON file is downloaded when it succeeds.

You can then import the extracted recipe from Add recipe -> Import.