Setup guide
About five minutes, once per Framer project.
1. Find your company handle
- Lever: the last part of
jobs.lever.co/your-handle. Tick "hosted in the EU" if your board is onjobs.eu.lever.co. - Greenhouse: the last part of
boards.greenhouse.io/your-handle. - Ashby: the last part of
jobs.ashbyhq.com/your-handle. - Personio: the first part of
your-handle.jobs.personio.de. The XML feed must be switched on in Personio under Settings › Recruiting › Career page.
2. Create a Framer Server API key
- Open your project in Framer and go to Site Settings › General.
- Under API keys, create a new key and copy it.
The key belongs to this one project. SyncRoles stores it encrypted and you can delete it from the plugin at any time, which stops all syncing.
3. Connect in the plugin
- Open SyncRoles from the Plugins menu, choose your hiring tool, enter the handle and click Find jobs.
- Paste your project URL (the address in your browser while the project is open) and the API key.
- Choose how publishing should work, then click Create Jobs collection and sync.
SyncRoles creates a CMS collection called Jobs with title, department, location, employment type, description, apply link and publish date. Build your careers page from it like any other CMS collection.
Publishing
Publishing in Framer always publishes the whole project. That is why you choose:
- I publish myself: jobs are updated in the CMS and go live the next time you publish.
- Publish when only jobs changed: SyncRoles publishes after a sync, unless the project already had unpublished page changes.
- Always publish: publishes after every sync that changed something, including any unfinished design work.
If something goes wrong
If your job board cannot be reached or suddenly returns no jobs at all, SyncRoles changes nothing and records the failure in the run log inside the plugin. Questions: info@smartprocesslab.de.