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@….

AddressEmail your app receivesTests
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.