Widgets

Widgets

Talent Search widgets serve as entry points to Talent Search. Your software must embed all provided widgets in easily discoverable places within its recruitment workflow for hirers with an active Talent Search Connect or Talent Search Custom contract with SEEK.
Widgets must be hidden for hirers that are not configured for Talent Search Connect or Talent Search Custom. You can use the hiringOrganization query to check for the required ProactiveSourcing relationship with a SEEK hirer:
QueryVariablesResult
query ($id: String!) {
  hiringOrganization(id: $id) {
    seekApiCapabilities {
      relationshipTypeCodes
    }
  }
}
Talent Search widgets are Web Components that are packaged and delivered as a JavaScript bundle. Web Components are technology agnostic and will work in conjunction with popular frontend frameworks such as Angular or React.

Widget types

Each widget can be interactively previewed in Storybook . Knobs allow you to try out different input options and receive immediate feedback on how a given widget will respond, while the Notes section contains detailed specifications and implementation guidance.

Talent Search Global Entry Point

Global entry menu button
Provides a link to Talent Search.

View SEEK Profile

Candidate has SEEK profile
Takes the email address of the candidate profile being viewed in your software and searches against Talent Search’s database for a corresponding SEEK profile. This widget will be blank if no matching SEEK profile is found.

Similar Candidates

Candidates that are similar to the one being viewed
Takes the email address of the candidate profile being viewed in your software and searches against Talent Search’s database for a corresponding SEEK profile. If a SEEK profile is found, it is used to find and display similar SEEK profiles. There are multiple sizes and orientations available for this widget.

Matching Candidates

Candidate has SEEK profile
Takes the position details being viewed and runs a search against Talent Search’s database for SEEK profiles that match the position details.
  • Suggested placement: Position details, position management, position creation pages
  • Recommended settings:
    • seekAndCombined="true" shows numbers for both shared profiles and SEEK-only profiles.
    • approachableOnly="true" filters by candidates whose activity on SEEK indicates they may be looking for a new role at the moment.
    • location accepts free text which is sent to a normalisation and resolution service to determine a location with which to filter the search. This works with a variety of inputs. It requires a country at minimum (e.g. Australia), but works best when a suburb, state and country are supplied.

How to embed widgets

  1. Include a <script> element with the following src attribute:
  2. Include a Talent Search component at the desired location, per the Notes section of its Storybook entry. For example, to include Matching Candidates:
    HTML
    Copy
    <ts-matching-candidates
      jobTitle="Developer"
      location="Melbourne"
      approachableOnly="true"
      seekAndCombined="true"
      layoutOrientation="horizontal"
    />
An example implementation with pure HTML/JS:
HTML
Copy
<html>
  <script
    async
    type="text/javascript"
    src="https://connected.talentsearch.seek.com.au/sdk/latest/bundle.js"
  ></script>

  <ts-matching-candidates
    jobTitle="Developer"
    location="Melbourne"
    approachableOnly="true"
    seekAndCombined="true"
    layoutOrientation="horizontal"
  />
</html>