Email tags
You sign in to Mockatoo with one account, but you can add a tag to its email
address to sign in as other users. Add the tag after a +, e.g.
you+1@example.com, and log in with your usual password (the one for
you@example.com). You don't need to sign up again.
Each tagged address is its own user. It always gets the same provider user ID
and username, and your app receives the tagged address as the user's email
(except for +returning, described below).
Getting another user
Use any tag that isn't a special tag, e.g. you+1@example.com,
you+2@example.com or you+another_user@example.com. These users act exactly
like you@example.com. They only get a different provider user ID and
username, so your app sees a new user. You can create as many as your tests
need, e.g. one per test, so tests don't share state.
Special tags
Some tags change what the provider does, so you can test edge cases, such as an unverified email, a missing name, or a token endpoint that's down. Each provider supports its own tags, and some tags behave differently from one provider to another. The page for each provider lists its tags and explains what they do:
When you're signed in, the account page at / lists every special tag for the
provider you pick.
Combining tags
Put a . between tags to combine them, e.g. you+hd.unverified@example.com.
You can also mix a special tag with an ordinary one, e.g.
you+2.unverified@example.com, to get a second unverified user that's separate
from you+unverified@example.com.
Every different address is a different user, including the same tags in
another order: you+hd.unverified@… and you+unverified.hd@… are two users.
Same user again
+renamed and +returning are the only tags that don't make a new user. They
keep the provider user ID of the address without them, so you+hd.renamed@…
and you+hd.returning@… are both the same user as you+hd@….
| Address | Email your app receives | Tests |
|---|---|---|
you+renamed@… | you+renamed@… | The user changed their email. |
you+returning@… | you@… | The user signs in again with the same email. |
+returning is the one tag your app never sees in the email, because a
returning user still has the email they had before. With Google and Apple it
also changes what the provider sends on a later sign-in; see their pages.
Apps that remove tags
If your app removes +tags from email addresses before it stores them, it
combines all these users into one. Turn that off in development and tests.