---
title: Web parts available for LinkedIn authentication
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

When you have [registered your application](https://docs.kentico.com/k8/managing-users/user-registration-and-authentication/linkedin-authentication/registering-your-application-to-linkedin.md) and after [configuration of the requiredsettings](https://docs.kentico.com/k8/configuring-kentico/managing-sites/configuring-settings-for-sites/settings-social-media/settings-linkedin.md), you may add the following web parts on pages of your website in order to enable users authenticate using their LinkedIn logon credentials.

## LinkedIn logon

This web part can be used to let site visitors sign in to your website using their LinkedIn logon credentials. It can be placed on any page of your website. The web part is hidden to authenticated users and will be displayed only to unauthenticated public site visitors. With default settings, the web part appears as in the following screenshot.

![](https://docs.kentico.com/docsassets/k8/web-parts-available-for-linkedin-authentication/Sign_in_with_linkedin.png)

Although the web part works fine with default settings, it has the following properties to fine-tune its behavior:

- **Sign in text** - if entered, a link with the entered text will be used instead of the default sign in image.
- **Sign out text** - if entered, a link with the entered text will be used instead of the default sign out image.
- **Show sign out** - if enabled, the web part will display a sign out link to authenticated users.
- **Show as button** - if enabled, buttons will be used instead of standard text links.
- **Sign in image** - specifies the URL of an image that will be used for the sign in button if the _Sign in text_ property is empty.
- **Sign out image** - specifies the URL of an image that will be used for the sign out button if the _Sign out text_ property is empty.
- **Required data for new users** - properties that determine which additional data the web part loads from LinkedIn accounts for the new Kentico user accounts. If you are using the _LinkedIn required data_ web part, the requested data will be pre-filled in the web part.

  > **Note:** **Note**: If you wish to enable the **Require birth date** property, you need to apply and be approved for the [Apply with LinkedIn](https://developer.linkedin.com/docs/apply-with-linkedin) program. Otherwise user registration and authentication will not work with this property enabled.
- **Notify administrator about new registrations** - if enabled, a notification e-mail will be sent to the website administrator when a new registration is performed via the web part.

## LinkedIn required data

In some cases, you may want new users to provide some extra details before their account is created. For example, if your site is configured to require [registration approval or double opt-in](https://docs.kentico.com/k8/managing-users/user-registration-and-authentication/configuring-forms-authentication/new-user-registration-approval-and-e-mail-confirmation.md), all users need a valid e-mail address to help activate their account.

This can be achieved using the _LinkedIn required data_ web part. The web part must be placed on the page specified by the **Required user data page** value in **Settings -> Social media -> LinkedIn**.

The following properties of the web part are the most important:

- **Allow forms authentication** - if checked, new users will be able to enter a password for their new account so that they can log in the usual way as well as via their LinkedIn logon credentials.
- **Allow existing user** - if enabled, users are allowed to join their existing accounts with the LinkedIn accounts.
- **Default target URL** - if no return URL is passed, users will be redirected to the URL entered here after merging or creating the account.
- **Hide for no LinkedIn** - if checked, the web part will be hidden if the page with it is displayed without LinkedIn logon (e.g. when accessed by entering its URL into the browser).