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.
DocumentationCanonical 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 |
Related profile
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.