{
  "id": "linkedin",
  "version": "1.0.0",
  "name": "LinkedIn",
  "description": "LinkedIn is the global professional-networking platform, a Microsoft subsidiary since 2016. The brand voice is professional, optimistic, and human — \"connect the world's professionals to make them more productive and successful.\" Visually, LinkedIn is anchored on LinkedIn Blue (#0A66C2) — the saturated mid-blue introduced with the 2019 brand refresh (darkened from the original #0077B5 to clear WCAG AA contrast on white at body size). The identity sits on a warm, light-first canvas with Source Sans serving as the open-source proxy for LinkedIn's in-house humanist sans.\n",
  "provenance": {
    "source": "https://brand.linkedin.com/",
    "license": "Proprietary — All Rights Reserved",
    "attribution": "LinkedIn and the LinkedIn \"in\" mark are registered trademarks of LinkedIn Corporation (a Microsoft subsidiary). The primary brand color (#0A66C2) is documented in LinkedIn's published brand guidelines at brand.linkedin.com and independently verified via the simple-icons brand database, which cites linkedin.com as the source. LinkedIn's published typography stack uses a proprietary humanist sans derived from Source Sans; brand-atoms references Source Sans 3 (already in the catalog) as the open-source equivalent.\n",
    "importedDate": "2026-05-18",
    "notes": "LinkedIn's identity is light-first: the canonical product surface is white with LinkedIn Blue on the in-bug, primary CTAs, and link color. The dark-mode role mapping is an authored inversion supporting LinkedIn's user-selectable product dark theme. The 2019 brand refresh darkened LinkedIn Blue from #0077B5 to #0A66C2 specifically to clear WCAG AA at body-text size.\n"
  },
  "tags": [
    "social",
    "professional",
    "linkedin",
    "blue",
    "corporate",
    "light-first",
    "microsoft"
  ],
  "palette": {
    "ref": "linkedin@1.0.0",
    "swatches": [
      {
        "id": "linkedin-blue",
        "name": "LinkedIn Blue",
        "value": "#0A66C2",
        "description": "Signature mid-blue — the primary brand color introduced with the 2019 brand refresh. The in-bug wordmark, primary buttons, and the link color on linkedin.com all read in this blue.\n",
        "aliases": []
      },
      {
        "id": "linkedin-blue-dark",
        "name": "LinkedIn Blue Dark",
        "value": "#004182",
        "description": "Darker blue for hover, pressed, and focus states on LinkedIn Blue — and the historical pre-2019 wordmark color region.\n",
        "aliases": []
      },
      {
        "id": "linkedin-blue-light",
        "name": "LinkedIn Blue Light",
        "value": "#378FE9",
        "description": "Lighter blue used for link affordances on dark surfaces and for hover hints on light surfaces.\n",
        "aliases": []
      },
      {
        "id": "linkedin-white",
        "name": "LinkedIn White",
        "value": "#FFFFFF",
        "description": "Canvas on light surfaces — the canonical LinkedIn product background.",
        "aliases": []
      },
      {
        "id": "linkedin-near-white",
        "name": "LinkedIn Near-White",
        "value": "#F4F2EE",
        "description": "Warm off-white background used on the LinkedIn feed and editorial pages.",
        "aliases": []
      },
      {
        "id": "linkedin-black",
        "name": "LinkedIn Black",
        "value": "#000000E6",
        "description": "Body and headline color — published as black at 90% opacity for use on white surfaces, balancing legibility with warmth.\n",
        "aliases": []
      },
      {
        "id": "linkedin-black-solid",
        "name": "LinkedIn Black Solid",
        "value": "#000000",
        "description": "Solid black — used in marketing and on the in-bug wordmark variants.",
        "aliases": []
      },
      {
        "id": "linkedin-text-secondary",
        "name": "LinkedIn Text Secondary",
        "value": "#00000099",
        "description": "Authored secondary text — black at 60% opacity for muted copy on white.",
        "aliases": []
      },
      {
        "id": "linkedin-divider",
        "name": "LinkedIn Divider",
        "value": "#E0DFDC",
        "description": "Authored hairline divider tone on light canvas.",
        "aliases": []
      },
      {
        "id": "linkedin-warm-orange",
        "name": "LinkedIn Warm Orange",
        "value": "#E68523",
        "description": "Warm orange — used sparingly on LinkedIn marketing surfaces and illustration to signal warmth and humanity.\n",
        "aliases": []
      },
      {
        "id": "linkedin-green",
        "name": "LinkedIn Green",
        "value": "#057642",
        "description": "Deep green — used in LinkedIn's product UI for \"open to work\" and positive status affordances.\n",
        "aliases": []
      },
      {
        "id": "linkedin-canvas-dark",
        "name": "LinkedIn Canvas Dark",
        "value": "#1B1F23",
        "description": "Authored dark-mode canvas for LinkedIn's product dark theme.",
        "aliases": []
      },
      {
        "id": "linkedin-surface-dark",
        "name": "LinkedIn Surface Dark",
        "value": "#2C3033",
        "description": "Authored elevated surface on dark mode.",
        "aliases": []
      }
    ],
    "modes": {
      "light": {
        "roles": {
          "background": "linkedin-white",
          "surface": "linkedin-white",
          "surface-elevated": "linkedin-near-white",
          "text-primary": "linkedin-black",
          "text-secondary": "linkedin-text-secondary",
          "text-tertiary": "linkedin-text-secondary",
          "primary": "linkedin-blue",
          "primary-hover": "linkedin-blue-dark",
          "accent": "linkedin-blue",
          "accent-hover": "linkedin-blue-dark",
          "warning": "linkedin-warm-orange",
          "warning-hover": "linkedin-warm-orange",
          "error": "linkedin-warm-orange",
          "success": "linkedin-green"
        }
      },
      "dark": {
        "roles": {
          "background": "linkedin-canvas-dark",
          "surface": "linkedin-surface-dark",
          "surface-elevated": "linkedin-surface-dark",
          "text-primary": "linkedin-white",
          "text-secondary": "linkedin-divider",
          "text-tertiary": "linkedin-divider",
          "primary": "linkedin-blue-light",
          "primary-hover": "linkedin-blue",
          "accent": "linkedin-blue-light",
          "accent-hover": "linkedin-blue",
          "warning": "linkedin-warm-orange",
          "warning-hover": "linkedin-warm-orange",
          "error": "linkedin-warm-orange",
          "success": "linkedin-green"
        }
      }
    }
  },
  "fonts": [
    {
      "role": "heading",
      "ref": "source-sans-3@1.0.0",
      "family": "Source Sans 3",
      "classification": "sans-serif",
      "source": {
        "kind": "google-fonts",
        "family": "Source Sans 3",
        "url": "https://fonts.googleapis.com/css2?family=Source+Sans+3:ital,wght@0,200..900;1,200..900&display=swap"
      },
      "fallbackStack": [
        "-apple-system",
        "BlinkMacSystemFont",
        "Segoe UI",
        "Roboto",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 200,
          "style": "normal"
        },
        {
          "weight": 200,
          "style": "italic"
        },
        {
          "weight": 300,
          "style": "normal"
        },
        {
          "weight": 300,
          "style": "italic"
        },
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 400,
          "style": "italic"
        },
        {
          "weight": 500,
          "style": "normal"
        },
        {
          "weight": 500,
          "style": "italic"
        },
        {
          "weight": 600,
          "style": "normal"
        },
        {
          "weight": 600,
          "style": "italic"
        },
        {
          "weight": 700,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "italic"
        },
        {
          "weight": 800,
          "style": "normal"
        },
        {
          "weight": 800,
          "style": "italic"
        },
        {
          "weight": 900,
          "style": "normal"
        },
        {
          "weight": 900,
          "style": "italic"
        }
      ]
    },
    {
      "role": "body",
      "ref": "source-sans-3@1.0.0",
      "family": "Source Sans 3",
      "classification": "sans-serif",
      "source": {
        "kind": "google-fonts",
        "family": "Source Sans 3",
        "url": "https://fonts.googleapis.com/css2?family=Source+Sans+3:ital,wght@0,200..900;1,200..900&display=swap"
      },
      "fallbackStack": [
        "-apple-system",
        "BlinkMacSystemFont",
        "Segoe UI",
        "Roboto",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 200,
          "style": "normal"
        },
        {
          "weight": 200,
          "style": "italic"
        },
        {
          "weight": 300,
          "style": "normal"
        },
        {
          "weight": 300,
          "style": "italic"
        },
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 400,
          "style": "italic"
        },
        {
          "weight": 500,
          "style": "normal"
        },
        {
          "weight": 500,
          "style": "italic"
        },
        {
          "weight": 600,
          "style": "normal"
        },
        {
          "weight": 600,
          "style": "italic"
        },
        {
          "weight": 700,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "italic"
        },
        {
          "weight": 800,
          "style": "normal"
        },
        {
          "weight": 800,
          "style": "italic"
        },
        {
          "weight": 900,
          "style": "normal"
        },
        {
          "weight": 900,
          "style": "italic"
        }
      ]
    },
    {
      "role": "mono",
      "ref": "jetbrainsmono-nerdfont@1.0.0",
      "family": "JetBrainsMono Nerd Font",
      "classification": "monospace",
      "source": {
        "kind": "external",
        "family": "JetBrainsMono Nerd Font",
        "notes": "Nerd-Font-patched build of JetBrains Mono. Not available via Google Fonts. Download woff2/ttf files from the Nerd Fonts GitHub release and self-host, or install system-wide for terminal/IDE use.\n"
      },
      "fallbackStack": [
        "JetBrains Mono",
        "Fira Code",
        "Menlo",
        "Monaco",
        "Consolas",
        "Liberation Mono",
        "monospace"
      ],
      "availableStyles": [
        {
          "weight": 100,
          "style": "normal"
        },
        {
          "weight": 100,
          "style": "italic"
        },
        {
          "weight": 200,
          "style": "normal"
        },
        {
          "weight": 200,
          "style": "italic"
        },
        {
          "weight": 300,
          "style": "normal"
        },
        {
          "weight": 300,
          "style": "italic"
        },
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 400,
          "style": "italic"
        },
        {
          "weight": 500,
          "style": "normal"
        },
        {
          "weight": 500,
          "style": "italic"
        },
        {
          "weight": 600,
          "style": "normal"
        },
        {
          "weight": 600,
          "style": "italic"
        },
        {
          "weight": 700,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "italic"
        },
        {
          "weight": 800,
          "style": "normal"
        },
        {
          "weight": 800,
          "style": "italic"
        }
      ]
    }
  ],
  "roles": {
    "colors": {
      "identity": "linkedin-blue",
      "on-identity": "linkedin-white",
      "primary": "linkedin-blue",
      "primary-hover": "linkedin-blue-dark",
      "accent": "linkedin-blue",
      "accent-hover": "linkedin-blue-dark",
      "success": "linkedin-green",
      "warning": "linkedin-warm-orange",
      "error": "linkedin-warm-orange",
      "background-light": "linkedin-white",
      "background-dark": "linkedin-canvas-dark",
      "surface-light": "linkedin-near-white",
      "surface-dark": "linkedin-surface-dark",
      "text-primary-light": "linkedin-black",
      "text-primary-dark": "linkedin-white",
      "text-secondary-light": "linkedin-text-secondary",
      "divider": "linkedin-divider"
    },
    "typography": {
      "display": "heading",
      "prose": "body",
      "code": "mono"
    }
  },
  "assets": [],
  "rules": [
    {
      "type": "colorChoice",
      "target": "logo.mark",
      "severity": "error",
      "rationale": "The LinkedIn in-bug renders in LinkedIn Blue, white (on dark surfaces), or black (in monochrome contexts). The supporting accents (warm orange, green) are reserved for product status affordances and never recolor the mark itself.\n",
      "allowed": [
        "linkedin-blue",
        "linkedin-blue-dark",
        "linkedin-white",
        "linkedin-black-solid"
      ],
      "forbidden": [
        "any-non-brand-color",
        "linkedin-warm-orange",
        "linkedin-green"
      ]
    },
    {
      "type": "forbiddenTreatment",
      "target": "logo",
      "severity": "error",
      "rationale": "LinkedIn's brand guidance prescribes the in-bug only in approved variants with adequate clearspace and forbids stretching, rotating, or recoloring the mark. The lockup with the \"Linked\" wordmark must respect the published proportions.\n",
      "treatments": [
        "stretched",
        "rotated",
        "recolored",
        "drop-shadow",
        "on-busy-photo",
        "inverted-without-variant",
        "placed-without-clearspace",
        "cropped"
      ]
    },
    {
      "type": "contrastRatio",
      "target": "text-primary",
      "severity": "error",
      "rationale": "WCAG 2.1 Level AA contrast minimum for body text. LinkedIn Black (rgba black at 90% on white) clears AA comfortably; the darkened 2019 LinkedIn Blue also clears AA on white at body size, which was the explicit motivation for the refresh.\n",
      "against": "background",
      "minRatio": 4.5,
      "standard": "WCAG-AA"
    },
    {
      "type": "contrastRatio",
      "target": "roles.colors.primary",
      "severity": "error",
      "rationale": "LinkedIn Blue (#0A66C2) on white reads at ~4.6:1 — clearing WCAG AA for body text. The 2019 refresh darkened the previous LinkedIn Blue (#0077B5, ~3.8:1) specifically to clear this threshold; the rule encodes that floor.\n",
      "against": "background",
      "minRatio": 4.5,
      "standard": "WCAG-AA"
    },
    {
      "type": "variantSelection",
      "target": "logo",
      "severity": "error",
      "rationale": "On dark surfaces, use the white in-bug variant for legibility. Do not place the LinkedIn Blue in-bug on dark canvases where it loses contrast against the background.\n",
      "when": {
        "backgroundColorScheme": "dark"
      },
      "use": "in-bug-white"
    },
    {
      "type": "variantSelection",
      "target": "logo",
      "severity": "error",
      "rationale": "On light surfaces, the in-bug renders in LinkedIn Blue — the canonical brand application across linkedin.com and marketing.\n",
      "when": {
        "backgroundColorScheme": "light"
      },
      "use": "in-bug-blue"
    },
    {
      "type": "contextRestriction",
      "target": "roles.colors.identity",
      "severity": "error",
      "rationale": "LinkedIn's brand-use guidance restricts use of the in-bug and wordmark in ways that imply affiliation, on competing-product surfaces, or on third-party merchandise without explicit license.\n",
      "forbiddenContexts": [
        "product-of-competitor",
        "merchandise",
        "endorsement-implication"
      ]
    },
    {
      "type": "compositionConstraint",
      "target": "roles.colors.identity",
      "severity": "recommendation",
      "rationale": "LinkedIn Blue + Warm Orange creates a saturated complementary tension that fights LinkedIn's calm professional voice. The Blue pairs cleanly with the warm-white canvas and the near-black text tone; reserve Warm Orange for editorial accents on a neutral canvas.\n",
      "pairsWith": [
        "linkedin-white",
        "linkedin-near-white",
        "linkedin-black-solid"
      ],
      "doesNotPairWith": [
        "linkedin-warm-orange"
      ]
    },
    {
      "type": "enumMembership",
      "target": "typography.heading.fontWeight",
      "severity": "warning",
      "rationale": "LinkedIn's display typography sits in the Regular (400), Semi-Bold (600), and Bold (700) band. Lighter cuts compromise the institutional, professional voice the platform's marketing depends on.\n",
      "allowed": [
        "400",
        "600",
        "700"
      ]
    },
    {
      "type": "accessibilityRequirement",
      "target": "*",
      "severity": "error",
      "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. LinkedIn's 2019 brand refresh was driven specifically by AA contrast considerations; the threshold is non-negotiable on LinkedIn-skinned surfaces.\n",
      "standard": "WCAG-AA",
      "criterion": "1.4.3"
    }
  ]
}