One set of functional options let you turn on or off built-in questions, like telephone number and cover letter. You can also add up to three "yes or no" questions of your own.

Another group of functional options allow you to specify various tracking information. This data is not displayed to the applicant, but will be sent to you to help with job reconciliation on your side.

Job Location

When you pass a data-companyId value, we will automatically set the job location to match the city and country of your company. But, if a job is in an alternative location, such as a foreign office or other venue, override the default using the data-jobLocation attribute:

      data-jobLocation="Hartford, Connecticut"

Phone Number

By default, the applicant is prompted to optionally provide you with their phone number. Use the data-phone parameter to switch this to required, to make it mandatory:

      data-phone="required"

Or hidden, to omit it:

      data-phone="hidden"

A value of optional preserves the default behavior. (Of course, this can be omitted since it's the default.)

      data-phone="optional"

Cover Letter

Similarly, you can choose to prompt for a cover letter. This time, the default is hidden, but you can enable it using either optional or required. The options behave exactly as they do above with data-phone:

      data-coverLetter="optional"

Your Questions

Some positions require an application to answer specialized questions. For example, you may want to know about an applicant's employment status, security clearance, or if they've recieved a necessary certification.

The data-question parameter allows you to pass a JavaScript array of three boolean questions. You provide the text, we insert them into the application with a checkbox.

You can either inline the data directly in the plugin, or refer to a pre-existing variable.

For example:

      data-questions='[{"question": "Do you have top secret clearance?"},{"question": "Have you passed the Series 7 Exam?"}]'

Or:

      var applyQuestions = '[{"question": "Do you have top secret clearance?"},{"question": "Have you passed the Series 7 Exam?"}]';
      data-questions=applyQuestions

The above parameters would create a plugin where the phone prompt is hidden, the user is allowed to optionally upload a cover letter, and there are two optional questions:
The code would be:

1
2
3
4
5
6
7
8
9

<script type="IN/Apply" 
    data-email="resumes@mycompany.com" 
    data-companyName="XYZ Company" 
    data-jobTitle="Chief Cat Herder" 
    data-coverLetter="optional" 
    data-phone="hidden"
    data-questions='[{"question": "Do you have top secret clearance?"},
                       {"question": "Have you passed the Series 7 Exam?"}]'>
</script>

Which translates into:

Job Id

Use the data-jobId parameter to allow you link this application to a job reference number in your system.

      data-jobId="LI-1234"

Additional Tracking Text

Beyond the job Id, you may wish to track additional data. For instance, if you're doing an A/B test of your application page and want to see which version drives higher quality applicants. Or, you could have the plugin in two different places, and want to see which source drives which people.

The data-meta parameter is a string that lets you pass any text you want. This will not be displayed to the user or acted on by LinkedIn to modify the behavior of the plugin. It's only used as a place for you to insert text of your own format that will be passed back to you for every application.

      data-meta="source:1,site:2"

Frame / IFrame Resizing

Apply with LinkedIn is compatible with frames and iframes. However, a common problem is sizing -- the plugin can grow and shrink depending on the user's profile, actions taken by the user, and the features you choose to add as a developer. To help ensure that your frame is large enough to accommodate the dialog, we've built an event called data-onResize. This fires anytime the dialog changes size, like opening or clicking 'Add Cover Letter' (it does not fire for the window close event). The callback you pass to data-onResize is passed information about the new width and height of the plugin, which you can use to resize your container frame. Sample code for how this would work is the following:

1
2
3
4
5
6
7
8
9
10
11
12
13

<script type="text/javscript">
     function resize(params) {
          var width = params.width;
          var height = params.height;
          // resize frame... using width/height from above using standard Javascript
     }
</script>
<script type="IN/Apply" 
    data-email="resumes@mycompany.com" 
    data-companyName="XYZ Company" 
    data-jobTitle="Chief Cat Herder" 
    data-onResize="resize">
</script>

Please note, you do not need to handle resizing unless you are using the Apply with LinkedIn button inside an iframe or a frame. The framework handles this for you automatically in all other cases.

More information about all of the styling parameters can be found on the Apply Parameters page.