Docs  Candidate Profiles  Display candidate summary and actions
  • No results found

Display candidate summary and actions

Before you begin

Ensure that you have reviewed the initial setup for Candidate Profiles.Review the contexts in which your software will surface SEEK Pass & SEEK Profile functionality. Generally, there are two:
  1. Candidate or applicant list
  2. Candidate details

Candidate or applicant list

Conditionally display SEEK Pass and SEEK Profile elements against each candidate in the list. The seekCandidateSummaries query lets you determine whether a given candidate has SEEK Pass verification and/or a SEEK Profile.

Retrieve summaries

Execute the seekCandidateSummaries query once per page of candidates, not once per candidate.
QueryVariablesResult
CopyGraphQL Explorer
query ($input: [SeekCandidateSummaryInput!]!) {
  seekCandidateSummaries(input: $input) {
    seekPrimaryEmailAddress
    seekProfile {
      exists
    }
    identity {
      formattedName
      isVerified


      icon {
        tooltipLabel
        images {
          accent
        }
      }
    }
  }
}

Render profile link

Use the response from the seekCandidateSummaries query to determine whether to show a profile link for each candidate:
  • If seekProfile.exists is true, render a link to the Candidate Profile Panel
  • If seekProfile.exists is false, do not render the link

Option 1: Text link Recommended

A text link may be used to represent the profile link:
Barista (Part-time)
NameSourceProfileStatus
Actions
John SmithSEEKView SEEK ProfileNew
Sarah JohnsonCareers websiteView SEEK ProfileShortlisted
Michael BrownOtherOffered
Emma WilsonSEEKView SEEK ProfileNew
David LeeOtherView SEEK ProfileShortlisted
Rachel GreenSEEKView SEEK ProfileNew
James TaylorCareers websiteView SEEK ProfileShortlisted
Lisa AndersonOtherOffered
Peter WrightSEEKView SEEK ProfileNew
Amy ChenCareers websiteShortlisted

Option 2: Icon link

Alternatively, you may represent the SEEK Profile with an icon button.
  • Use a tooltip to explain the meaning of the icon
  • The tooltip copy should be: View SEEK Profile
  • Your software must not modify the icon
Barista (Part-time)

Assets

SEEK will provide a bundle of SEEK Profile icon assets, including pre-approved buttons, text, and logo assets. You can always find the latest version below.
seek-profile.svg
Last updated: 2025-12-09

Render verification result

Use the response from the seekCandidateSummaries query to determine whether to show a verification result for each candidate:
  • If identity.isVerified is true, render the verification result
  • If identity.isVerified is false, do not render the verification result
Identity verification must conform to our display requirements:
  1. Render the SEEK Pass badge to denote the verification resultYour software must not modify it.
  2. Surface the formattedName alongside the badgeThis allows hiring managers to easily verify that the verification was performed on the correct candidate.

Design guidance

  • Display the SEEK Pass icon next to the candidate’s name.
  • Display a tooltip when hovering over the icon.
  • Retrieve the icon and its tooltip from the identity.icon field of the seekCandidateSummaries query.
  • If the response identity.icon.tooltipLabel cannot be used, the tooltip copy should be: Verified by SEEK Pass as {formattedName}.
  • Include a legend on your page with a badge that explains the meaning of the SEEK Pass icon.
Barista (Part-time)
NameSourceProfileStatus
Actions
John Smith
SEEKView SEEK ProfileNew
Sarah Johnson
Careers websiteView SEEK ProfileShortlisted
Michael Brown
OtherOffered
Emma Wilson
SEEKView SEEK ProfileNew
David Lee
OtherView SEEK ProfileShortlisted
Rachel Green
SEEKView SEEK ProfileNew
James Taylor
Careers websiteView SEEK ProfileShortlisted
Lisa Anderson
OtherOffered
Peter Wright
SEEKView SEEK ProfileNew
Amy Chen
Careers websiteShortlisted
Legend:
Verified by SEEK Pass

Assets

SEEK will provide a bundle of Verified by SEEK Pass icon assets, including pre-approved buttons, text, and logo assets. You can always find the latest version below.
verified-by-seek-pass-light.svgverified-by-seek-pass-dark.svg
Last updated: 2025-12-09

Candidate details

Unconditionally display a link to the Candidate Profile Panel with prominent placement in the view. For example, a tabbed view may include a dedicated SEEK Profile tab.
Rachel Green
The Candidate Profile Panel will gracefully handle scenarios where the candidate does not have a SEEK Profile.
Candidate Profiles: Verify with SEEK Pass
Candidate Profiles: Display panel