Sharing a recipe
A share link is a URL that opens one of your recipes on a read-only page. Anyone with the link can read the recipe. They don’t need an account, and they can’t change anything.


Making one
Section titled “Making one”Open the recipe, then ⋯ → Share… and press Create a link. The URL appears immediately, ready to copy.
Nobody else can see a recipe until you create a link for it.
Several links to one recipe
Section titled “Several links to one recipe”One recipe can have up to 20 live links at once, so you can revoke one without breaking the others. Make one for the forum thread and one for your brew club, and when the forum link needs to go away, the brew club’s link keeps working.
What the page shows
Section titled “What the page shows”The recipe: name, style, vitals, fermentables, hops, yeast, water treatment, mash and fermentation schedules, and your notes. We calculate it with your equipment profile, so the OG and volumes a reader sees are the same numbers you see.
Whoever opens it can switch between US and metric units, since a shared recipe is as likely to be read in Munich as in Denver.
Nothing else from your workspace is shared. Readers don’t see your other recipes, your batches, your inventory or your settings, and they see nothing about you unless you choose to add your name (below).
It shows the recipe as it stands now
Section titled “It shows the recipe as it stands now”A link always shows the current recipe. Fix a typo and everyone with the link sees the fix. Change the hop schedule and they see the new one. If you want to send a version that won’t change, export the recipe as BeerJSON and send the file.
Your name on a link
Section titled “Your name on a link”By default, a shared page doesn’t show who wrote it.
If you have claimed a display name, the share dialog offers Share with your name. Check it before pressing Create, and that link’s page shows your name and your picture. If you haven’t uploaded a picture, we show your initials instead.
- It is chosen per link, before the link exists. The box applies to the link you are about to make, not to the recipe and not to your account.
- It can’t be changed afterward. A link someone already has shouldn’t start or stop showing your name without them knowing. To change your mind, make another link and hand that one out instead. Links made before this feature existed don’t show a name, and they never will.
- It always shows your current name. Rename yourself and every page with your name on it updates too. If you delete your profile or your account, the pages stop showing a name, but the recipe is still readable.
The dialog marks which of a recipe’s links show your name, so you don’t have to open one to find out.
Publishing to the gallery
Section titled “Publishing to the gallery”Sharing a link is private, because you decide who gets the URL. Publishing to the gallery is public. It lists the recipe under your name in a directory anybody can browse, and puts a Clone to my workspace button on its shared page.
If the recipe doesn’t have a link with your name on it, publishing makes one for you, so it’s one step instead of two.
- A listing shows the version you published. Publishing saves the recipe as it is at that moment, and both the card and the page it opens show that version. Editing the recipe afterward doesn’t change either one. Press Update listing when you want the gallery to show your changes. Until you do, your recipe has a Listing out of date badge, and the gallery’s My listings tab shows the same badge for everything you’ve published.
- A shared link always shows the current recipe.
/s/…updates as you edit, so a typo you fix is fixed for everyone with the link. Publishing doesn’t change that. - Removing a listing does not revoke the link, though revoking the link does remove the listing from the gallery. They are separate switches. Removing also deletes the listing’s likes and clone count for good, so we ask twice.
Taking it back
Section titled “Taking it back”Press Revoke beside a link and it stops working right away. The next person to open it sees “This link is not available”, and so does anyone who already had the page open and reloads it.
Deleting the recipe has the same effect on every link pointing at it.
A revoked link, an unknown link and a link to a deleted recipe all show the same page. That way, someone trying out URLs can’t tell which kind they’ve found, or whether the link ever worked.
Journals
Section titled “Journals”A journal shares the same way, with two differences. Each journal has one link instead of several, and the page updates as you go. Every block you add appears on it, and every block you hide disappears from it. You choose whether the link shows your name when you make it. Stop sharing in the journal’s share dialog turns it off.
What a reader sees of the rest of your workspace depends on which blocks they can see. A visible Recipe, Fermentation chart or Blend block shows the batch or blending session it points to, including the recipe as brewed, the readings and the beers that went into the blend. A hidden block shows nothing at all, and we don’t send its batch or blend to the reader’s browser. A visible File block offers its file as a download, and a hidden one’s file can’t be reached at all. Your tags stay private either way, on a journal as on a recipe.
Blends
Section titled “Blends”A blending session shares the same way a journal does. Press Share in the session header and we make one link, which updates as you go. Top up the barrel or add a row of cherries and the page shows it the next time somebody opens it.
The page opens with your notes on the blend, the story you would tell whoever you handed a bottle to, and the days you blended, conditioned and packaged it. Under that are the beers that went in, with their gravities, their color and whether they came out of a barrel; the fruit, sugar, herbs and tinctures you folded in with them and when each went in and came out; and the finished blend: its total volume, its strength, its color and pH, and once it is packaged, the carbonation it was packaged to. Whoever opens it can switch between US and metric units, as they can on a shared recipe.
Two things stay private. The cellar actions you scheduled on the blend aren’t on the page, since “pull the oak cubes, taste it first” is a note to yourself about next Tuesday. And each batch or session a beer came from is shown as a name without a link, so a reader can see that a third of the blend was your three-year lambic without being able to open the lambic’s own page. A blend shown in a shared journal doesn’t include your notes on the blend either. The reader only sees what you wrote in the journal.
Stop sharing in the same dialog turns it off, and the next person to open the link sees that it isn’t available.
How a link works
Section titled “How a link works”The link ends in a long random code that your browser generates and we store with your account. Anyone with the link can read the page, and nobody can guess one, and nothing in the address identifies you or your workspace.
Treat the URL as a secret. Anyone you send it to can send it on, and revoking the link is how you take that back.
We ask search engines not to cache or index shared pages, so one that finds a link shouldn’t keep it. Search engines follow that request, but nothing forces them to, which is another reason to revoke a link you no longer want out there.
Related
Section titled “Related”- The gallery, for publishing rather than sending.
- Your profile, for what a reader sees about you.
- Recipe history and versions, for sharing a version rather than the live recipe.
- Blending, for the sessions a blend link opens.
Something wrong on this page? Tell us.