> ## Documentation Index
> Fetch the complete documentation index at: https://help-empuls.xoxoday.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LinkedIn

> Connect LinkedIn to Empuls so employees can share recognition to their LinkedIn profiles and your team can amplify awards externally.

The LinkedIn integration adds a one-click **Share to LinkedIn** option to recognition awards and milestone posts. When an employee receives a recognition or hits a service-award milestone, they can post the achievement to their LinkedIn profile in a couple of taps — turning internal recognition into an external talent-brand signal.

## Before you start

* You must be a **Super Admin** in Empuls to enable the integration org-wide.
* Individual employees authorize their own LinkedIn account the first time they share — there's no per-user admin step.
* LinkedIn's content policies apply to anything shared from Empuls.

## How it works

<Steps>
  <Step title="Enable LinkedIn org-wide">
    From the Integrations hub, click **LinkedIn → Configure** and toggle **Enable LinkedIn sharing** on.
  </Step>

  <Step title="Pick which events get a share button">
    Choose which Empuls events surface a **Share to LinkedIn** button — recognition received, service-award milestone, jury award won, leaderboard top finish. Most organizations enable all four.
  </Step>

  <Step title="Set a default post template (optional)">
    Provide a default post body with placeholders like `{{award_name}}`, `{{company_name}}`, and `{{completed_year}}`. Employees can edit before posting.
  </Step>

  <Step title="Save">
    The Share button now appears on the chosen Empuls events. Each employee links their own LinkedIn account the first time they use it.
  </Step>
</Steps>

## What the employee sees

1. An eligible Empuls event (for example, a service-award post on the feed) shows a **Share to LinkedIn** button.
2. Clicking it opens a LinkedIn auth screen the first time. Subsequent uses skip auth.
3. The default post body appears, pre-filled with placeholders resolved against the event data.
4. The employee edits and clicks **Post**. The update appears on their LinkedIn profile.

## Customizing share content

The default template supports:

* `{{first_name}}`, `{{last_name}}` — employee's display name
* `{{award_name}}` — title of the award or milestone
* `{{company_name}}` — your Empuls program name (from [Branding](/admin/platform-settings/branding))
* `{{completed_year}}` — for service awards, the anniversary year
* `{{citation}}` — the recognition citation text

Employees can edit freely before posting; the template only sets the default.

## Limits and gotchas

* LinkedIn requires the employee's account to be in good standing (no recent policy violations) for sharing to succeed.
* Posts respect LinkedIn's visibility rules — they appear on the employee's profile, not on your company page.
* Disabling LinkedIn org-wide hides the share button immediately. Already-posted updates stay on LinkedIn.

## Related

<CardGroup cols={2}>
  <Card title="Branding" href="/admin/platform-settings/branding">
    Set the program name that appears in LinkedIn posts.
  </Card>

  <Card title="Awards & core values" href="/admin/programs/awards-core-values">
    Configure which awards are LinkedIn-shareable.
  </Card>

  <Card title="Service awards" href="/admin/gifts/milestones-service-awards">
    Drive external visibility for milestone anniversaries.
  </Card>
</CardGroup>