SD eJuice Calculator — User Guide
Everything you need to know to get the most out of the calculator. Use the table of contents or the search box to jump to any section.
😕 No sections match your search. Try a different keyword.
1 Getting Started

Registering

  1. Click Register in the top navigation bar.
  2. Choose a username (3–30 characters, letters/numbers/underscores only).
  3. Enter a valid email address and a password of at least 8 characters.
  4. Click Register — a verification email will be sent to you immediately.

Email Verification

Check your inbox for an email from SD eJuice Calculator. Click the verification link inside. You won't be able to use your account fully until your email is verified.

Note: If admin activation is required, your account may show as pending until an admin approves it. You'll be notified by email when activated.

Logging In

Click Login in the top navigation. Enter your username or email and your password. Use Forgot Password if needed — a reset link will be emailed to you.

↑ Back to top
2 Your Profile & Preferences

Access your profile by clicking your username in the top navigation bar, then Profile.

⭐ Important Preferences: Three settings have the biggest impact on your day-to-day experience — set these first:
  • Mix by — choose Volume (ml) or Weight (grams). This bolds your preferred column in the Mix Sheet and in exported PDFs.
  • Flavor autocomplete — choose All flavors (full database) or Stash only (only what you own). Stash-only keeps searches fast and personal.
  • Following notifications — turn this on if you want email alerts when mixers you follow publish new recipes.

Calculator Defaults

Save time by setting your personal defaults so the calculator pre-fills the way you always mix:

SettingWhat it does
Default batch sizeHow many ml the calculator opens with
Default PG/VG ratioYour usual base ratio
Default nic base strengthThe mg/ml strength of your nicotine stock
Default nic PG%How much of your nic base is PG
Default target strengthYour usual finished mg/ml target
Default steep daysPre-fills the steep time on new recipes
Mix byVolume (ml) or Weight (grams) — bolds the relevant column in the Mix Sheet
Flavor autocompleteSearch all flavors in the database, or stash only

Avatar / Gravatar

SD eJuice Calculator supports Gravatar. Register your email at gravatar.com to set a profile image — it will appear automatically next to your recipes and comments. Check the Use my Gravatar box in your profile to enable it.

Notification Preferences

  • Newsletters — opt in/out of site announcement emails
  • Following notifications — receive an email when a mixer you follow publishes a new public recipe
  • Steeping notifications — receive an email when your recipes have passed their steep time and are ready to vape

Public Bio

Add a short bio (up to 2,000 characters) that appears on your public profile page. Other users can view your profile by clicking your username anywhere on the site.

Changing Your Password

A dedicated Change Password section is available at the bottom of your profile page. Enter your current password and your new password twice to confirm.

↑ Back to top
3 The Calculator

The calculator is the heart of the site. Access it from the Calculator link in the main navigation.

Base Settings

The BASE SETTINGS panel is expanded by default at the top of the calculator.

FieldDescription
Batch size (ml)How many ml you want to make
PG ratioYour target PG percentage
VG ratioAuto-calculates to keep PG + VG = 100%
Nic base strengthThe mg/ml of your nicotine stock
Nic PG %The PG content of your nic base (affects gram weight calculations)
Target strengthYour desired finished nicotine level in mg/ml
Water %Optional — adds distilled water to the mix
Steep daysFor your records when saving or logging

Flavors Section

The FLAVORS panel is expanded by default below Base Settings.

  • Type in the flavor search box — it searches the full flavor database (or your stash only, depending on your profile setting).
  • Enter a percentage for each flavor. (Average flavor usage is pre-filled).
  • Click + Add Flavor to add more rows.
  • The calculator updates the Mix Sheet live as you type.

Flavor Carrier

Each flavor row has three carrier pills below its name: PG, VG, and Other. These tell the calculator what liquid the flavor concentrate is suspended in, which affects the mix math.

CarrierWhat it meansEffect on calculation
PGStandard PG-based flavor (default for most brands)Flavor volume counts toward PG pool — PG diluent is reduced accordingly
VGVG-based flavor (some Max VG concentrates)Flavor volume counts toward VG pool — VG diluent is reduced accordingly
OtherPEG, PDO, alcohol, or other neutral carrierFlavor volume is removed from total before the PG/VG split is calculated — neither pool is affected

If a flavor is in your stash with a carrier already set, selecting it from the autocomplete will automatically apply that carrier preference. You can always override it for a specific recipe — changing it in the calculator does not change your stash setting.

Stash alert: If any flavor in your recipe isn't in your stash, a yellow warning bar appears with an Add to Shopping List button.

Notes & Image

Click ▼ NOTES to expand.

  • Add free-text notes to your recipe (visible to others if the recipe is public).
  • Paste an Imgur image URL to attach a photo to your recipe.

The Mix Sheet

The Mix Sheet updates in real time as you adjust your inputs. It shows:

  • BASE — Nicotine, PG, VG (and Water if used)
  • TOTAL BASE — combined ml, grams, and percentage
  • FLAVORS — each flavor with ml, grams, and percentage
  • Totals row — your full batch
  • Ratio bar — a visual colour-coded breakdown of Nic / PG / VG / Flavor / Water
  • Summary — Strength, PG/VG ratio, Flavor total, Steep time, Total volume, Total weight
Gram weights use accurate densities: PG = 1.036 g/ml, VG = 1.261 g/ml, Nicotine = weighted blend based on its PG/VG composition.

Cost Tracking

If you've entered bottle sizes and costs for your supplies in My Stash, the calculator will display a live cost estimate for the batch, broken down by ingredient, with a per-10ml cost.

Saving a Recipe

Click Save Recipe. You'll be prompted to give the recipe a name, add notes, set it as Public or Private, and optionally attach an Imgur image URL. Saved recipes appear in My Recipes.

Logging a Mix

Click Log Mix to save a record of the batch to your Mix Log. Choose Record only to just log the event, or Record & subtract from stash to automatically deduct flavor amounts from your inventory.

Printing

Click Print to get a clean print-formatted version of your Mix Sheet.

Loading a Recipe

Opening a recipe from the Recipe Index or My Recipes pre-loads all values automatically. You can adjust any value and re-mix without altering the saved recipe.

One-Shot Mode: If you open a recipe that was saved as a One-Shot concentrate, the calculator enters One-Shot mode automatically. See Section 13 — One-Shot Mode for full details.
↑ Back to top
4 Recipes

Browsing the Recipe Index

Go to Recipes in the top navigation. Search by name or author, browse A–Z, or sort by Recipe Name, Author, Rating, or Date. Each row shows the recipe name, flavor list preview, author, rating, and date.

Viewing a Recipe

Click any recipe name to open the full recipe page — complete Mix Sheet, recipe badges, author, date, notes, and image.

Logging a Mix from a Recipe

Logged-in users can click Log Mix on any recipe page to record a batch directly to their Mix Log.

Rating a Recipe

Rate any public recipe using the 1–5 star system. Your rating saves immediately and can be changed at any time.

Commenting

Leave a comment on any public recipe. Recipe owners and admins can delete any comment. You can delete your own.

Adapting a Recipe

Open someone else's recipe in the calculator and save it — the site automatically records it as Adapted from the original with a link back, giving credit to the original author.

Editing & Deleting Your Recipes

On your own recipe page you'll see Edit and Delete buttons. Edit opens a full form where you can change any field, update flavors, or adjust privacy.

↑ Back to top
5 My Recipes

Access via User → My Recipes.

Search & Sort

Use the search bar to filter your recipes by name, or browse A–Z using the letter filter. Click column headers to sort by Recipe Name, Rating, or Date — click again to reverse the order. The active sort column is highlighted in yellow.

Folders

  • Click + Create to make a new folder
  • Click the icon to rename, to delete (recipes inside move back to Main)
  • Click a folder name to view only its recipes
  • Drag the ≡ handle to reorder folders

Recipe Options (Bulk Actions)

Click the blue ☑ Recipe Options button to enter select mode, then:

ActionWhat it does
DeletePermanently deletes selected recipes
Make PublicMakes selected recipes visible to all users
Make PrivateHides selected recipes from public view
Move to FolderMoves selected recipes into a chosen folder

Click ✕ Cancel to exit select mode without making changes.

↑ Back to top
6 Your Stash

Access via User → My Stash. Your stash is your personal flavor inventory.

Each flavor in your stash appears as a row in the table. Click the ▶ caret (or anywhere on the row) to expand it and reveal the editable fields — bottle size, cost, on-hand quantity, alert level, carrier, and your private notes. Click again to collapse. This keeps the list tidy when you have a large stash.

Adding Flavors Manually

Use the ➕ Add Flavor to Stash card at the top. Search for a flavor by name and click Add.

Stash Fields

FieldDescription
Bottle mlThe size of the bottle you bought
Cost / bottleWhat you paid for it
On Hand mlHow much you currently have
Alert mlGet a low-stock warning when on-hand drops below this
CarrierThe liquid base for this concentrate — PG (default), VG, or Other (PEG, PDO, alcohol, etc.). Sets the default carrier when this flavor is selected in the calculator. Saves immediately on click.
LocationWhere you store this flavor — shelf name, bin, box, or any label that helps you find it physically. Visible only to you.
Private NotesPersonal tasting notes, usage tips, and percentages — visible only to you

These fields power the cost calculator, carrier-aware mix math, and stash subtraction features.

Searching & Filtering

  • Search by flavor name or manufacturer
  • Sort by Name, Manufacturer, Date Added, On Hand, or Alert status
  • Filter to show only low-stock flavors

Removing Flavors

Click the icon on any stash row to remove that flavor from your stash.

↑ Back to top
7 Importing Your Stash

Access via User → Import Stash. Quickly populate your stash from an existing flavor list rather than adding flavors one by one.

Supported Formats

FormatHow to get it
ELR stash exportOn e-liquid-recipes.com: My Flavor Stash → Export as CSV (top of the page)
VCC stash exportOn vapingcommunity.co.uk: My Flavours → Export. Format is detected automatically.
CSV (comma-delimited)Any spreadsheet with flavor names in standard format
TSV (tab-delimited)Tab-separated flavor list
Single columnOne flavor name per line (e.g. "Lemon (MF)")

The importer auto-detects the format — you don't need to specify it.

What Gets Imported

  • Flavor name & manufacturer — matched against the SD eJuice Calculator flavor database
  • Notes — imported as private flavor notes, visible only to you on each flavor's detail page (ELR format)
  • Volume (ml on hand) — imported if the Import Volumes option is checked (ELR format)

The Import Process

  1. Upload a CSV/text file or paste your flavor list directly into the text box
  2. Click Preview Import — the importer shows you the first 50 flavors and a summary
  3. Review the results: Matched / Pending / Already in stash
  4. Click Confirm Import to commit, or Cancel to abort — nothing is written until you confirm

Tips

  • If a flavor isn't found, it's submitted as pending for admin review
  • Manufacturer abbreviations are normalized automatically (e.g. "TFA" → "TPA", "Flavorah" → "FLV")
  • You can re-import at any time — duplicates are automatically skipped
↑ Back to top
8 Importing Recipes

Access via User → Import Recipes. Bring your existing recipe collection over from ELR or VCC in one go rather than recreating recipes by hand.

Recipe import vs Stash import: This section covers importing your recipes (the full mix formulas). If you want to import your flavor inventory instead, see Section 7 — Importing Your Stash. They're separate tools with separate upload pages.

Supported Formats

The recipe importer supports two formats — detected automatically from the file:

FormatHow to export
ELR (e-liquid-recipes.com)Go to My page / Favorites → click Export to CSV at the top of the page
VCC (vapingcommunity.co.uk)Go to My Recipes → click Export. Steep days are imported automatically from VCC exports.

What Gets Imported

  • Recipe name, notes, and image URL
  • Flavors and percentages — matched against the SD eJuice Calculator database
  • PG/VG ratio, batch size, steep time, and nicotine strength
  • New flavors — any flavor not yet in the database is automatically submitted for admin review; you can use it in your own recipes immediately
  • Stash additions — flavors from your imported recipes can be added to your stash automatically

The Import Process

  1. Upload your ELR export file or paste the CSV data directly into the text box
  2. Click Preview Import — you'll see the first 50 recipes with a full summary
  3. Review what will be imported — duplicates already in your recipe list are flagged and skipped
  4. Click Confirm Import to commit, or Cancel to abort — nothing is written until you confirm

After Import

  • All imported recipes land in My Recipes as private — make them public individually if you choose to share
  • Any unrecognized flavors show as pending in the flavor database until an admin approves them
  • You can import again at any time — duplicates are automatically detected and skipped
↑ Back to top
9 Mix Log

Access via User → Mix Log. Every time you click Log Mix in the calculator or on a recipe page, a record is saved here.

Summary Stats

  • Total mixes logged
  • Total ml mixed
  • Total spent (if cost data is available)
  • Last mixed date

Searching

Use the search bar to find specific recipes in your log by name.

Each Log Entry Shows

  • Recipe name (linked to the original recipe if it still exists)
  • Date and time mixed, batch size, strength, PG/VG ratio
  • Cost (if tracked) and flavor list

Mix Again

Click 🔄 Mix Again on any log entry to open that recipe in the calculator, pre-loaded and ready to mix.

Undoing a Mix

If you subtracted from your stash when logging, click Undo to reverse the stash deduction and remove the log entry.

Deleting a Log Entry

Click Delete to remove a log entry permanently. This does not restore stash quantities — use Undo for that.

↑ Back to top
10 Flavor Index

Access via Flavors in the top navigation. Browse the full approved flavor database.

Searching & Filtering

  • Search by flavor name or manufacturer name
  • Filter by manufacturer using the dropdown
  • Browse A–Z by first letter
  • Sort by Name, Manufacturer, Date Added, Recipes (how many recipes use it), or Rating — click a column header to sort, click again to reverse. The active sort column highlights in yellow.

Adding a New Flavor

If a flavor you're searching for isn't in the database yet, simply type it into the calculator as-is and save your recipe. It will be submitted automatically for admin review, and once approved it becomes available to all users.

Please follow the Flavor Naming Guide for correct name formatting — consistent naming keeps the database clean and searchable for everyone.
↑ Back to top
11 Flavor Detail Page

Click any flavor name to open its detail page — usage stats, ratings, community notes, and your own private notes all in one place.

Actions

ButtonWhat it does
+ Add to StashAdds the flavor to your personal stash
View in StashOpens your stash filtered to this flavor (if already in stash)
🛒 Add to Shopping ListAdds to your shopping list for future purchase
Search My RecipesSearches your recipes for this flavor
All RecipesShows all public recipes using this flavor

Private Notes

Add your own private notes — personal tasting notes, usage tips, percentages you like. Visible only to you. Notes from your ELR stash import also land here automatically.

Community Notes

See what other mixers have shared about this flavor. Add your own public note to contribute to the community knowledge base.

Recipes Using This Flavor

A list of public recipes that include this flavor, so you can discover how others are using it and at what percentages.

↑ Back to top
12 Shopping List

Access via User → Shopping List. A simple list of flavors you want to buy.

Flavors are added from:

  • The Flavor Index or Flavor Detail page (Add to Shopping List button)
  • The Calculator stash alert (when a flavor in your recipe isn't in your stash)

Managing Your List

  • Sort by Name or Date Added
  • Click Remove to take a flavor off the list once you've bought it
  • Click a flavor name to go to its detail page
↑ Back to top
13 One-Shot Mode

What is a One-Shot?

A One-Shot (OS) is a pre-mixed flavor concentrate that contains all the flavors in a recipe, ready to be added to your base (PG, VG, and nicotine) when you're ready to mix. Instead of measuring each flavor individually, you measure one bottle of concentrate into your base.

One-Shots are useful for:

  • Batch-producing a concentrate you mix frequently
  • Sharing recipes with others without disclosing individual flavor percentages
  • Simplifying your mixing session — one measurement instead of many

Creating a One-Shot from an Existing Recipe

Any recipe you own can be converted into a One-Shot. Open the recipe, click Recipe Options, then choose Make One-Shot. This creates a new recipe — your original is untouched.

The new One-Shot recipe will:

  • Be tagged with a ONE-SHOT badge
  • Show a "Based on [Original Recipe] by [Author]" attribution line
  • Have all base fields (PG, VG, Nicotine) zeroed out — because a One-Shot contains only flavors

How the Calculator Works in One-Shot Mode

When a One-Shot recipe is loaded in the calculator, a yellow banner appears:

ONE-SHOT MODE — Flavor-only concentrate based on [Recipe Name]. Base fields are zeroed — add your PG/VG/nic when ready to mix the finished liquid. Mix at X% in finished liquid.

This is the key concept: in One-Shot mode the calculator rescales all your flavor percentages to fill 100% of the batch. So if your recipe's flavors originally totalled 12%, those flavors now fill the entire bottle. The PG, VG, and nicotine fields are locked at zero — they'll be added later when you use the concentrate.

Understanding the Mix Sheet in One-Shot Mode

The Mix Sheet will show:

ItemWhat it means
BASE rows (Nic, PG, VG)All show 0.00 ml — no base is added to the concentrate
FLAVORS rowsRescaled to fill 100% of the batch. A flavor that was 8% in the original recipe might show ~66% here
Ratio barSolid orange — 100% flavor, no base
Flavor totalEqual to your full batch size (e.g. 30.00 ml / 100%)
Example: Fruity McLoops has flavors totalling 11.98%. To make a 30ml One-Shot, the calculator divides each flavor by 11.98% and multiplies by 100%, then scales to 30ml. Fruit Circles (SilverLine) at 8% becomes ~66.78% of the concentrate, or ~20.03ml of the 30ml bottle.

The Usage Rate — Mixing the Finished Liquid

The yellow banner tells you the usage rate: "Mix at X% in finished liquid." This is the percentage of One-Shot concentrate to add when making your final e-liquid.

The usage rate equals the original total flavor percentage of the recipe. So if the recipe's flavors totalled 11.98%, you add your One-Shot at 11.98% into your finished batch.

StepWhat to do
1. Make the concentrateMix your One-Shot bottle using the rescaled amounts from the Mix Sheet
2. Set your batch sizeDecide how much finished liquid you want (e.g. 100ml)
3. Add the One-ShotUse X% of your batch size as One-Shot (e.g. 11.98ml into 100ml)
4. Fill the restAdd your PG, VG, and nicotine as you normally would for the remaining 88.02ml
You can use the regular calculator (non-One-Shot) to work out the PG/VG/nic amounts for your finished batch — just set your desired strength, PG/VG ratio, and reduce flavors to 0% (since the concentrate provides all the flavor).

One-Shot Recipes in My Recipes

One-Shot recipes appear in My Recipes with the ONE-SHOT badge next to the recipe name. When viewed on the recipe page, the ingredient table shows the rescaled concentrate percentages and the "Based on" attribution to the original recipe.

One-Shot Recipes in the Recipe Index

If you make a One-Shot public, it appears in the public recipe index with the One-Shot badge. Other users can view the concentrate formula and use the Mix This button to load it into their calculator in One-Shot mode.

↑ Back to top
14 Following Mixers

SD eJuice Calculator has a follow system so you can stay up to date with mixers whose recipes you enjoy.

Following a Mixer

Visit any member's public profile page and click the Follow button. You'll immediately start receiving notifications when they publish new public recipes.

Stop Following

Click the Stop Following button on their profile page at any time to stop receiving notifications from that mixer.

Email Notifications

When a mixer you follow publishes a new public recipe, you'll receive an email notification with a link to the recipe — as long as Following notifications is enabled in your profile preferences. You can turn this on or off at any time under User → Profile → Notification Preferences.

Your Followers

Your own profile page shows how many users are following you, and how many mixers you are following. Click either count to see the list.

↑ Back to top
15 Member Profiles

Every user on SD eJuice Calculator has a public profile page. Click any username anywhere on the site — in recipes, comments, or the member list — to view their profile.

What a Profile Shows

SectionWhat it contains
AvatarGravatar image if enabled, or a default avatar
BioA short description the member has written about themselves (up to 2,000 characters). URLs in bios are automatically turned into clickable links.
StatsNumber of public recipes, followers, and following count
Public RecipesAll their publicly shared recipes, searchable and sortable
Follow / Stop FollowingButton to follow or stop following that mixer

Your Own Profile

Access your own profile via User → Profile. From there you can edit your bio, enable your Gravatar, and manage notification preferences. See Section 2 — Profile & Preferences for full details.

↑ Back to top
16 Exporting Recipes

The Export Recipes feature lets you download your entire recipe collection — or any selection — as a single, professionally formatted PDF. Access it via User → Export Recipes.

What's in the PDF

Every export includes:

SectionDetails
Cover PageYour username, export date, recipe count, and a link back to SD eJuice Calculator
Table of ContentsEvery recipe listed in alphabetical order with clickable links to jump directly to that page
Bookmark SidebarA persistent navigation panel in your PDF viewer listing all recipes — click any name to jump instantly. Works in Adobe Reader, Firefox, Chrome, and Edge.
Recipe PagesOne page per recipe — ingredient table (ml, g, %), batch summary, steep time, total flavor %, and notes
Preferred Mix HighlightYour preferred mixing style (by weight or volume) is highlighted in gold and bolded throughout every recipe

Export Options

OptionWhat it does
Include Image LinksAdds a clickable Imgur URL to each recipe that has an image — click it in your PDF viewer to open the image in your browser
Export AllGenerates a single PDF of your entire collection in one click — no selection required
Export SelectedAppears when you have recipes checked — exports only your selection. Count updates live as you check/uncheck.

Filtering and Selecting

Use the Filter by name box to narrow the recipe list — type any part of a recipe name and the list updates instantly. Use Select Visible to check all currently filtered recipes, then hit Export Selected to export just that subset. Deselect All clears all checkboxes at once.

Progress Bar

When you start an export, a progress overlay appears showing generation status. For smaller collections it may jump straight to 100% — the server generates PDFs very quickly. For large collections (500+ recipes) you may see the bar advance in real time. Either way, the download triggers automatically when generation completes.

Navigating Large PDFs

For large recipe collections, two navigation tools make finding recipes fast:

  • Bookmark Sidebar — open the "Document Outline" or "Bookmarks" panel in your PDF viewer (usually a tab on the left side). Every recipe is listed and clickable.
  • Ctrl+F / Cmd+F — your PDF viewer's built-in search works across the entire document including recipe names, flavor names, and notes.

Tips

  • Even a collection of 1,000+ recipes exports as a single PDF — no splitting or ZIP files.
  • The TOC page numbers are approximate — use the bookmark sidebar for the most reliable navigation in very large exports.
  • One-Shot recipes are clearly marked with an [OS] badge in the TOC and a gold ONE-SHOT badge on their recipe page.
  • Your preferred mix style (weight or volume) is automatically applied — the correct column is highlighted gold and bolded on every recipe.
↑ Back to top
SD eJuice Calculator — built for mixers, by a mixer.