Documentation
Usage Guide
Everything you need to know about using Muddled — from creating your first recipe card to managing team workspaces.
On this page
Getting Started
Create your account and start building your cocktail recipe collection.
- 1
Create an account
Sign up with email and password, or use Sign in with Apple or Google.
- 2
Create your first recipe
Click "+ New recipe" on the My Recipes page. Fill in the name, method, ingredients, and instructions.
- 3
Explore the community
Browse public recipes from other bartenders. Save the ones you like to your collection.
- 4
Import existing recipes
Already have recipes elsewhere? Use the Import feature to bring them in from URLs, photos, or other apps.
Muddled is available on both web and iOS. Your recipes, settings, and preferences sync automatically between platforms via your account.
My Recipes
Your personal recipe collection — create, organize, and manage all your cocktail specs.
- -Create recipes with name, method, ingredients, instructions, garnish, rim, glass, ABV, and tasting notes
- -Edit any recipe by clicking the Edit button on the recipe detail page
- -Duplicate a recipe to create a variation without losing the original
- -Delete recipes with confirmation to prevent accidents
- -Search by recipe name or ingredient name
- -Filter by cocktail method (Shaken, Stirred, Built, Blended, and more)
- -Set visibility per recipe: Private, Public, or Workspace
- -Upload a photo for each recipe
- -Organize recipes into collections — create collections with custom colors, add/remove recipes, set public or private
- -Swipe left on any recipe to quickly delete or duplicate (iOS)
How to create a recipe
- 1
Click "+ New recipe" in the top-right corner
- 2
Fill in the recipe name and select a cocktail method
- 3
Add ingredients with amounts and units (oz, ml, dash, etc.)
- 4
Write the preparation instructions
- 5
Optionally add garnish, rim, glassware, ABV, and tasting notes
- 6
Choose visibility (Private, Public, or Workspace)
- 7
Click "Save recipe card" to create it
When you have fewer than 3 recipes, the app shows classic cocktail templates you can start from — perfect for getting a feel for the format.
Recipe Detail
View, scale, convert, and manage individual recipes.
- -Batch scaling — multiply all ingredients by 1x, 2x, 3x, or 5x for larger batches
- -Unit conversion — toggle between oz (imperial) and ml (metric) with bartender-friendly jigger snapping
- -QR code — generate a shareable QR code for any public recipe that links to its web page
- -Version history — view and restore previous versions of a recipe (auto-saved on every edit)
- -Lock/unlock — workspace owners can lock recipes to prevent editors from modifying them
- -Recipe photo — displayed at the top of the card when uploaded
- -Print as PDF — export any recipe as a printable card in 4x6 index card or A5 format
- -Ingredient substitutions — see alternative ingredient suggestions inline (e.g., "or rye whiskey")
Batch scaling
Click the scale buttons (1x, 2x, 3x, 5x) above the ingredient list. All amounts update instantly. Your unit preference is remembered across recipes.
Version history
Every time you edit a recipe, the previous version is automatically saved. Click the clock icon to browse past versions, preview any snapshot, and restore it if needed. Restoring creates a new version — you never lose data.
Print as PDF
Click the PDF button on any recipe detail page. Choose between 4x6 index card (standard bar card size) or A5 format. The PDF downloads instantly with your recipe name, ingredients, instructions, garnish, rim, ABV, tasting notes, and any substitution notes — all formatted for clean printing on white paper.
Your measurement preference (oz or ml) is saved locally and applied automatically when you view any recipe.
Importing Recipes
Bring recipes into Muddled from any source — URLs, photos, other apps, or plain text.
Click the Import button on the My Recipes page to open the import hub. Four methods are available:
1. Import from URL
Paste any recipe page link. Works with Punch, Imbibe, Difford's Guide, Saveur, Liquor.com, Food & Wine, and most cocktail sites. AI extracts the recipe automatically.
2. Upload a photo
Upload a JPEG, PNG, or WebP image of a recipe card, index card, or handwritten note. AI reads the image with vision and extracts the spec.
3. From another app
Export recipes from Highball, Mixel, BarSpoon, Cocktail Flow, or any other cocktail app. Select your source app for tailored export instructions, paste the text, and AI parses it.
4. Paste from Notes
Copy a recipe from iPhone Notes, Apple Notes, or any text source and paste it. Supports bullet lists, numbered steps, and free-form text. AI handles the rest.
After import, you always get a review screen where you can edit every field before saving. Check the AI confidence badges to see which fields need your attention.
Templates
Start from a classic cocktail and make it your own.
When you have fewer than 3 recipes, the My Recipes page shows 9 classic cocktail templates: Margarita, Old Fashioned, Negroni, Daiquiri, Manhattan, Whiskey Sour, Espresso Martini, Aperol Spritz, and Mojito.
- 1
Click any template card on the My Recipes page
- 2
The recipe form opens pre-filled with the classic spec
- 3
Modify anything — change ratios, swap ingredients, rename it
- 4
Save as your own recipe
Templates are a great way to learn the recipe card format. Once you have 3+ recipes, templates are hidden — but you can always create a new recipe from scratch.
Community
Discover and save recipes shared by bartenders around the world.
- -Browse a feed of public recipes from all users
- -Filter by cocktail method using the chip buttons
- -Save/bookmark any recipe for quick access later
- -View featured collections — curated packs of classic and modern cocktails
- -Click any recipe to see the full detail with ingredients, instructions, and more
- -Visit author profiles to see all their public recipes
- -Follow other users to stay updated
Featured Collections
At the top of the Community page, horizontal scroll cards showcase curated recipe packs like “Spirit-Forward Classics,” “The Sour Family,” and “Modern Classics.” Click a collection to browse and import recipes from it into your library.
Search
Find public recipes by name across the entire community.
Navigate to the Search page from the sidebar. Type a recipe name and results appear in real-time as you type. Results are debounced (300ms delay) to keep things fast.
On the My Recipes page, the search bar also lets you search your own collection by recipe name or ingredient name.
Workspaces
Collaborate with your bar team — share recipes, assign roles, and manage access.
- -Create workspaces for your bar, restaurant, or team
- -Invite team members with 6-character invite codes
- -Assign roles: Owner (full control), Editor (can edit unlocked recipes), Viewer (read-only)
- -Lock recipes to prevent editors from modifying finalized specs
- -All workspace recipes are shared — everyone with access can view them
- -Owners can remove members and manage invite codes
How to set up a workspace
- 1
Go to Workspaces in the sidebar
- 2
Click "+ New workspace" and enter a name
- 3
Click "Invite" on your workspace to generate a code
- 4
Choose a role (Editor or Viewer) for the invite
- 5
Share the 6-character code with your team member
- 6
They go to Workspaces, click "Join", and enter the code
Recipe locking
Workspace owners can lock any recipe by clicking the lock icon on the recipe detail page or the workspace recipe grid. When locked, editors can view but not modify the recipe. Owners can always edit regardless of lock state.
Workspaces require a Bar subscription. Invite codes expire after 7 days and are single-use.
Profile & Settings
Manage your account, preferences, and data.
- -Edit your display name, username, and bio
- -Upload a profile avatar photo
- -Set default batch scale (1x, 2x, 3x, or 5x) for new recipes
- -Set default visibility (Private or Public) for new recipes
- -Export all your recipes as a JSON file for backup
- -View support links: send feedback, privacy policy, terms of service
- -Sign out or delete your account (irreversible, requires confirmation)
- 1
Click your avatar or name in the top-right corner
- 2
Edit any field and click "Save Profile"
- 3
To export recipes, scroll to the Data section and click "Export My Recipes (JSON)"
Your preferences (default scale, visibility, measurement system) sync between iOS and web automatically.
Subscription Tiers
Muddled offers three tiers to fit your needs.
Free
Get started
- - Up to 10 recipe cards
- - Community browsing
- - Recipe import (AI)
- - Batch scaling & unit conversion
Pro
For serious bartenders
- - Unlimited recipe cards
- - Menu builder
- - Everything in Free
Bar
For teams & venues
- - Team workspaces
- - Invite codes & role management
- - Recipe locking
- - Everything in Pro
Subscriptions are currently managed through the iOS app on the App Store. Your subscription tier syncs automatically to the web app.