AllRecipes Web Ingredient Substitution Overlay

WHAT IT DOES

AllRecipes Web Ingredient Substitution Overlay reads the ingredient list from any AllRecipes recipe page and displays helpful substitution suggestions for each ingredient. Common substitutions are shown for ingredients like butter, milk, eggs, flour, sugar, and dozens more. Each ingredient with a substitution available gets a badge showing the number of options. Clicking the badge opens a popup with all suggested substitutions. The extension also highlights common allergens—dairy, gluten, egg, soy, nuts, and peanuts—with red badges and visual indicators on the ingredient list. You can add custom substitutions for any ingredient directly from the popup, and these are saved for future use. The panel shows a summary of all ingredients, including which have substitutions and which contain allergens.

WHERE IT RUNS

This extension works on all AllRecipes pages at allrecipes.com and its subdomains, specifically on recipe pages where ingredients are listed. It runs on the main recipe view, the ingredient list section, and any page displaying recipe ingredients. The extension operates entirely within your browser and does not access AllRecipes' servers directly—it reads only what is visible on the page you are viewing. It works alongside the free BotGentz extension, which provides the necessary scripting environment.

HOW TO USE

Install the extension, then navigate to allrecipes.com and open any recipe. The extension automatically scans the ingredient list and displays a panel with substitution and allergen information. Click the extension's icon in your browser toolbar to open the panel. The panel shows all ingredients with badges indicating available substitutions and allergen presence. Click any substitution badge to open a popup with the full list of substitution options for that ingredient. To add a custom substitution, type it into the input field at the bottom of the popup and click "Add"—it will be saved for that ingredient. Use the "Show substitutions" toggle to control whether substitution badges appear. Use the "Highlight allergens" toggle to control allergen highlighting. The "Refresh Ingredients" button manually rescans the page. The "Clear Custom Subs" button removes all saved custom substitutions.

KEYWORD-BASED INGREDIENT NORMALIZATION WITH PATTERN MATCHING

Unlike simple string matching, this extension uses a two-stage ingredient normalization engine. First, it cleans the ingredient text by removing quantities, units, and parenthetical notes using a comprehensive regex pattern. The cleaned ingredient name is then compared against a database of common ingredients using both exact matching and sub-string matching. The database includes over 50 common ingredients with their typical substitutions. For each ingredient, the system extracts the base name and checks for partial matches when exact matches fail. The allergen detection uses a separate keyword list organized by allergen type, scanning the original ingredient text to catch mentions like "almond milk" (nuts) or "whole wheat flour" (gluten). Custom substitutions are stored as a key-value object where keys are cleaned ingredient names and values are arrays of custom options. This approach ensures accurate substitution detection even when ingredient names vary in format.

THE PANEL

The panel supports drag-to-move anywhere on the page. It remembers its position per site, so it stays where you placed it on allrecipes.com. Click the panel header to collapse it down to just the minimized bubble, or click the expand handle to show the full panel. The panel can be resized by dragging the bottom-right corner. Press the Escape key to close the expanded panel and return to the minimized state. All panel settings, including position, size, collapsed state, substitution visibility, and allergen highlighting, are saved per site and persist across browsing sessions.

PLEASE NOTE

This extension requires the free BotGentz extension to be installed and active, as it provides the underlying DOM injection and script execution environment. AllRecipes' website changes periodically, and ingredient element structures, class names, and page layouts may be updated. When that happens, the extension may stop detecting ingredients until an update is released. The extension stores your substitution visibility, allergen highlighting preference, and all custom substitutions locally in your browser's storage using GM_setValue. Custom substitutions are stored as a key-value object where keys are ingredient names and values are arrays of substitution options. No data is ever sent to any server, and no personal information is collected. The extension does not read or store your AllRecipes login credentials, email, or any identifying information. You can clear all stored settings and custom substitutions at any time using the "Clear Custom Subs" button or by clearing your browser data for allrecipes.com.