Personalization

Prospect field reference

The prospect namespace is linkedin. It combines convenient canonical fields with normalized profile data. Optional fields reflect the information available in the source profile.

Documentation

Canonical Page fields

Path Meaning
linkedin.first_name Prospect’s first name.
linkedin.last_name Prospect’s last name.
linkedin.full_name Full name.
linkedin.headline Profile headline.
linkedin.job_title Current job title.
linkedin.company_name Current company.
linkedin.location Display location.
linkedin.profile_picture Profile image URL, with the renderer’s fallback behavior.
linkedin.company_logo Company logo URL when available.

Extended normalized profile

The following inventory describes the extended normalized profile fields. Optional values depend on the information available in the source profile. For AI template authoring, use the canonical fields above; extended fields describe the data available to manually authored templates.

Optional fields can be empty when the source profile has no value. Use the documented properties below when working with structured profile data.

Path Shape
linkedin.city nullable string
linkedin.state nullable string
linkedin.gender nullable string
linkedin.groups opaque array
linkedin.skills opaque array
linkedin.country nullable string
linkedin.summary nullable string
linkedin.articles Array of article
linkedin.headline nullable string
linkedin.industry nullable string
linkedin.education Array of education
linkedin.full_name nullable string
linkedin.interests opaque array
linkedin.languages Array of string
linkedin.last_name nullable string
linkedin.activities Array of activity
linkedin.birth_date nullable date
linkedin.first_name nullable string
linkedin.occupation nullable string
linkedin.connections nullable integer
linkedin.experiences Array of experience
linkedin.location_str nullable string
linkedin.certifications Array of certification
linkedin.follower_count nullable integer
linkedin.volunteer_work Array of volunteer work
linkedin.inferred_salary opaque nullable value
linkedin.personal_emails Array of string
linkedin.profile_pic_url nullable image url
linkedin.recommendations Array of string
linkedin.personal_numbers Array of string
linkedin.country_full_name nullable string
linkedin.public_identifier string
linkedin.entity_urn nullable string
linkedin.people_also_viewed Array of related profile
linkedin.accomplishment_courses Array of course
linkedin.accomplishment_patents opaque array
linkedin.accomplishment_projects opaque array
linkedin.similarly_named_profiles Array of related profile
linkedin.accomplishment_test_scores opaque array
linkedin.background_cover_image_url nullable image url
linkedin.accomplishment_publications opaque array
linkedin.languages_and_proficiencies Array of language proficiency
linkedin.accomplishment_honors_awards Array of honor award
linkedin.accomplishment_organisations opaque array

Nested object and list item shapes

Use a loop for an array and refer to each item’s properties. Nested dates contain nullable day, month, and year; partial dates are possible. The tables below describe the structure of each object and list item.

Date

Context: date.

Property Shape
day integer or null
month integer or null
year integer or null

Experience

Context: linkedin.experiences[].

Property Shape
starts_at nullable date
ends_at nullable date
company nullable string
title nullable string
location nullable string
logo_url nullable image url
description nullable string
company_facebook_profile_url nullable string
company_linkedin_profile_url nullable string
company_urn nullable string
company_id nullable string
company_website nullable string

Education

Context: linkedin.education[].

Property Shape
starts_at nullable date
ends_at nullable date
field_of_study nullable string
degree_name nullable string
school nullable string
grade nullable string
description nullable string
activities_and_societies nullable string
logo_url nullable image url
school_facebook_profile_url nullable string
school_linkedin_profile_url nullable string

Article

Context: linkedin.articles[].

Property Shape
author nullable string
image_url nullable image url
link nullable string
published_date nullable date
title nullable string

Activity

Context: linkedin.activities[].

Property Shape
link nullable string
title nullable string
activity_status nullable string

Certification

Context: linkedin.certifications[].

Property Shape
url nullable string
name nullable string
starts_at nullable date
ends_at nullable date
authority nullable string
display_source nullable string
license_number nullable string

Volunteer work

Context: linkedin.volunteer_work[].

Property Shape
starts_at nullable date
ends_at nullable date
company nullable string
title nullable string
cause nullable string
description nullable string
logo_url nullable image url
company_linkedin_profile_url nullable string

Context: linkedin.people_also_viewed[] / linkedin.similarly_named_profiles[].

Property Shape
link nullable string
name nullable string
summary nullable string
location nullable string

Language proficiency

Context: linkedin.languages_and_proficiencies[].

Property Shape
name nullable string
proficiency nullable string

Course

Context: linkedin.accomplishment_courses[].

Property Shape
name nullable string
number nullable string

Honor award

Context: linkedin.accomplishment_honors_awards[].

Property Shape
title nullable string
issuer nullable string
issued_on nullable date
description nullable string

Use only available, appropriate data

{% if linkedin.company_name != blank %}
  <p>Built for teams like {{ linkedin.company_name | escape }}.</p>
{% endif %}

For loops, use an item alias such as experience.title. The raw schema’s occupation, location_str, and profile_pic_url are distinct from convenience fields such as job_title, location, and profile_picture; do not assume identical semantics.

AI template authoring uses its available-variable catalog. For manually authored templates, variables and Liquid syntax explain the runtime fields and conditional rendering patterns.

Search guides and MCP references in one place.