Comeet allows you to embed several types of widgets:
- Application Form – applicants can use Comeet’s rich functionality to apply for positions on your website.
- Social – leverage employee referral programs by allowing company employees to easily share positions on social media and automatically track their referrals.
- Careers Website – quickly embed the complete careers website functionality into your website.
To support any of these widgets, start by adding the following code to the <head> section of your page. Place your configuration parameters in the configuration object and add additional parameters as needed. See the full list of supported parameters below.
Allowlist your domains
Define the domains on which the widgets can be embedded to prevent any improper use. To do so, open the Careers website settings (requires an Admin or Owner role) and add the domains on which the widgets are allowed to be embedded in the field Integrated website domains.
Track candidates sources
To support tracking of candidate sources add this code to the
<head>section of all of the pages of your careers website. Learn more about how Comeet tracks candidates sources here.
<!-- Comeet Careers API -->
<script>
window.comeetInit = function() {
COMEET.init({
"token": "-- your token --",
"company-uid": "-- your company uid ---",
"company-name":"-- your company name ---",
"candidate-source-storage": false,
"color": "278fe6", //optional
"font-size": "13px" //optional
//add more parameters here
});
};
(function(d, s, id) {var js, fjs = d.getElementsByTagName(s)[0]; if (d.getElementById(id)) {return; } js = d.createElement(s); js.id = id;
js.src = "//www.comeet.co/careers-api/api.js"; fjs.parentNode.insertBefore(js, fjs); }(document, 'script', 'comeet-jsapi'));
</script>
<!-- Comeet source attribution -->
<script>(function(){var a=function(){window.COMEET.set("candidate-source-storage",!0)};window.COMEET?a():window.comeetUpdate=a})();</script>
The following parameters can be added to the configuration. NOTE: parameters added directly to widgets can override those in the section of your page.
Context:
| Name | Description | Required |
|---|---|---|
| token | Company token | required |
| company-uid | Company UID | required |
| company-name | Company name | required for the Careers Website Widget |
| candidate-source-storage | Use false as shown in the example above. This parameter is used by Comeet's widgets to allow support for a cookie consent manager | required for supporting a cookie consent manager |
| position-uid | Position UID | required |
| thankyou-url | After applying, the applicants will be redirected to the specified url. This setting can only be set up during initialization | optional |
| language | Localize the experience for candidates and employees. The following languages are supported:en - English (default)fr - Frenchde - Germanes - Spanishru - Russian | optional |
| beta | Use this during development to test the upcoming version of the widgets before it is made the main version. When set to true the widgets will be rendered using the Beta version. Make sure to not include this parameter in a production environment. | optional |
Style:
| Name | Description | Required |
|---|---|---|
| css-url | URL to a custom CSS file for customizing the widgets. Learn more | optional |
| css-cache | When developing your CSS, you may want to set this value to false to prevent the widget from using the cached CSS. Default is true | optional |
| color | Leading color for buttons and links. Default is 278fe6 | optional |
| background-color | Background color for the form. Default is white | optional |
| button-color | Color for the button. Defaults to the value of color above | optional |
| font-size | Font-size used. Default is 13px | optional |
| button-font-size | Font size of buttons if you want it different from the text. Defaults to the value of font-size above | optional |
Colors
Button and link colors should be dark enough to permit readability. If you choose a light color you may see it rendered as a darker color than the given one.