Signing in to Berrybell
Berrybell asks for your email address, then offers only the ways that address can sign in. Google and GitHub, where they're enabled, can be used straight away without typing anything. This page covers creating your account, signing in, and the confirmation and password-reset emails, including how often they can be sent.
This page covers how you sign in to Berrybell. How the people who use an app you build sign in to it is a separate feature — see Sign-in for your app's users.
In the messages quoted below, you@example.com stands for your address and example.com for your company's email domain.
Creating an account
The sign-up screen is headed Create your account. You reach it from Don't have an account? Sign up on the sign-in screen, and an invitation link opens on it directly.
Continue with Google and Continue with GitHub are on screen from the start, before you type anything — but only where those sign-in options are enabled. If you don't see them, sign up with your email.
To sign up with your email:
- Type your address and press Continue.
- Fill in Name (optional — your email address stands in for it if you leave it empty) and Password (at least 8 characters).
- Complete the bot check if one appears, then press Sign up.
An email account has to confirm its address before it can be used. The screen changes to Confirm your email — "We sent a confirmation link to you@example.com" — and the email, "Verify your email for BerryBell", has a Verify email button. The link expires in 1 hour. Clicking it confirms the address and signs you in; there's no separate sign-in step. An expired or already-used link shows "That verification link is invalid or has expired. Sign in and we'll send you a fresh one." Signing in with your password sends a new link.
The first time you sign in, Berrybell creates a workspace named after you — for example "Alex's Workspace", or your email address in place of the name if you left Name empty. If you arrived from an invitation, you join that workspace instead and no new one is created.
Signing in: email first
The sign-in screen is headed Sign in to continue. Type your email and press Continue; the button reads Checking… while Berrybell looks the address up. Google and GitHub buttons, where enabled, are already on screen above the email field, and you can use them without typing anything.
After Continue, the screen shows only the ways that account can sign in, always in this order:
- Continue with SSO — if your company has set up single sign-on
- Continue with Google
- Continue with GitHub
- A Password field and Sign in — if the account has a password
A line under the email field says what Berrybell found:
| The account signs in with | The line reads |
|---|---|
| Single sign-on | "Your company uses single sign-on." |
| Single sign-on and a password | "Your company uses single sign-on. You can also use your password." |
| "You sign in with Google." | |
| GitHub | "You sign in with GitHub." |
| Google and GitHub | "You sign in with Google or GitHub." |
| Google and a password | "You sign in with Google, or use your password." |
| GitHub and a password | "You sign in with GitHub, or use your password." |
| Google, GitHub and a password | "You can sign in with Google, GitHub, or your password." |
| A password only | "Signing in as you@example.com." |
An address with no account shows "No account for you@example.com." and a Create an account button, which takes you to the sign-up form with the address already filled in.
If you typed your address before pressing Continue with Google, Google preselects that account rather than asking you to pick one.
Addresses aren't case-sensitive, and spaces before or after them are ignored: You@Example.com and you@example.com are the same account.
When the check can't run
If Berrybell can't look the address up, you can still sign in. The screen shows every option at once: the enabled Google and GitHub buttons, the Password field with Sign in, and — on the sign-in screen — a small Use single sign-on (SSO) link in place of the Continue with SSO button. A line under the email field says why:
- You're offline: "You're offline. Enter your password to continue, or reconnect and try again."
- The lookup failed or took more than 4 seconds: "Couldn't check that email — enter your password to continue."
- The address was checked too often — 20 checks for one address in a day, or 20 checks in a minute from one network: "Too many attempts. Try again in a few minutes." This limits the check, not the sign-in; the options on screen still work.
Last used on this device
After a successful sign-in, your browser remembers how you signed in for 30 days:
- Google or GitHub: that button gets "Last used on this device" underneath it. The button order doesn't change.
- Single sign-on: the sign-in screen leads with Continue with example.com, named after your company's domain, which takes you to your identity provider in one click without typing your email. "Last used on this device" and a Not you? link sit underneath; Not you? forgets it. Only the domain is stored, never your address.
- Email and password: nothing is shown, and it replaces any earlier Google, GitHub or single sign-on marker.
This is kept in a browser cookie, so clearing cookies forgets it. If your company's single sign-on connection has been removed, pressing the remembered button shows "Single sign-on is not enabled on this server." If its domain is no longer verified, it shows "Single sign-on for example.com isn't available any more. Sign in with your email below." Either way, Berrybell stops offering the button; sign in with your email instead.
Signing up with an address that already has an account
On Create your account, if the address you enter already has an account, the screen stops after Continue and says so, with one button for the way in that works:
| The line reads | The button |
|---|---|
| "you@example.com already has an account through your company's single sign-on." | Continue with SSO |
| "you@example.com already has an account, and it signs in with Google." | Continue with Google |
| "you@example.com already has an account, and it signs in with GitHub." | Continue with GitHub |
| "you@example.com already has an account that hasn't been confirmed yet." | Resend the confirmation email |
| "you@example.com already has an account. Sign in instead." | Sign in |
If you came from an invitation, the line reads "you@example.com already has an account. Sign in to join the workspace." instead; the button still matches how the account signs in.
A Use a password instead link also appears when an account that leads with Google, GitHub or single sign-on has a password as well. It takes you to the sign-in screen with the password field open.
If the check couldn't run (see When the check can't run) and you sign up with an address that already has an account, the screen still moves to Confirm your email, but no confirmation link is sent. Instead, the address's owner gets an email, "Someone tried to sign up with your BerryBell email", with a Go to sign-in button — at most one a minute and 5 an hour. Nothing is created, and nothing about the existing account changes.
Email limits
On Confirm your email, Resend email unlocks 60 seconds after the last email and counts down until then as Resend in Ns. At most 5 confirmation emails go to one address per hour. Past that, pressing it shows "Too many attempts. Try again in Ns.", or "Too many attempts. Try again in a few minutes." when the wait is longer than 2 minutes.
Signing in with the password of an account that isn't confirmed yet also sends a fresh link and takes you to Confirm your email. That email counts toward the same limits, and once they're reached no new email goes out until the wait is over.
Reloading the tab keeps you on Confirm your email. Back to sign in leaves it.
Forgot your password
- On the sign-in screen, press Forgot your password?
- Enter your email, complete the bot check if one appears, and press Send reset link.
The answer is always "If an account exists for you@example.com, a password reset link is on its way.", whether or not the address has an account. The same limits as confirmation emails apply — one per minute and 5 per hour for each address — and requests beyond them are dropped without telling you.
The reset link expires in 1 hour and opens Choose a new password. Enter a New password (at least 8 characters) and press Set new password. You're returned to the sign-in screen with "Password updated — sign in with your new password.", and you receive a "Your BerryBell password was changed" email. If you didn't change it, use Forgot your password? straight away.
An expired or invalid reset link shows "That reset link is invalid or has expired. Request a new one below.", with the reset form open.
Where you land after signing in
After signing in you land on the home screen, not on the page you opened while signed out. If you followed a link to a particular project or settings page, open it again once you're in. Invitation links are the exception: they take you into the workspace you were invited to.
Next steps
- Sign in with your company's identity provider: SSO
- Invite people and set what they can do: Team & roles