Instant authorization technology
Users can log in to your website with their Yandex accounts. To provide this option, add one of the two authorization components to your page: an instant login widget or a button.
- If the user is already logged in to their Yandex account on the current device, the widget or button will display their avatar and name, allowing the user to proceed with logging in to your website.
- If the user hasn't logged in to their Yandex account yet, they can use the widget or button to do so.
When the user confirms logging in, they are taken to an OAuth authorization screen with a list of data that they are allowing your app to access.
Authorization component's appearance
You can use an instant login widget or a login button to let users access your service.
Tip
Use the widget to improve conversion rate on your website.
An instant login widget is a pop-up window on your website that enables the user to log in with their Yandex account.
-
If the user is logged in:
-
If the user isn't logged in:
A login button is a button element for quick login to Yandex ID.
You can add different button versions to your website:
-
A personal button.
The personal button's appearance depends on whether the user is logged in to their Yandex account on the current device.-
If the user is logged in:
-
If the user isn't logged in:
-
-
An icon button with the Yandex logo.
This version is used when there's not enough space for a full-size button. Include a "Log in with" text description in the icon button's container.
Limitations
Instant authorization won't work if the user's browser is set to:
-
Block iframes.
-
Disable JavaScript.
Additionally, the widget won't work if the following settings are used in the browser:
-
Third-party cookies are blocked.
-
No cookies at all are allowed. In this case, an error is returned when calling YaAuthSuggest.init.
Without cookies, you can only use a login button.