Quick Start Guide (5 Minutes)
Follow these simple steps to connect Teamtailor to your Framer project:
Step 1: Install & Open the Plugin
In Framer, open your project and launch Teamtailor to Framer Sync from the Plugins menu.
Step 2: Activate your Polar License Key
If you haven't yet purchased a license, use the Polar checkout link. Once purchased, copy your XXXX-XXXX-XXXX-XXXX license key, paste it into the activation input, and click Activate License. Your key is stored securely in your browser's private local storage.
Step 3: Enter Your Teamtailor API Token
In Teamtailor, navigate to Settings > Integrations > API keys and create an API key with Read permission. Copy the key, select your region (EU, North America, or Asia-Pacific), and click Test Connection. The plugin connects directly to Teamtailor to verify the credentials.
Step 4: Configure Managed Collection & Map Fields
Create a new Framer Managed Collection or select an existing one. Review the field mapping schema:
- Title: Job position name
- Slug: Automatic URL slug with collision deduplication
- Body / Pitch: Clean semantic HTML job description
- Department: Automatically resolved from linked department entities
- Location: Automatically resolved from linked location entities
- Remote Status: Remote, Hybrid, or On-site
- Employment Type: Full-time, Part-time, Contract, or Internship
- Apply URL: Direct applicant submission link
Step 5: Preview & Sync
Click Preview Sync. Review the delta diff cards (Added, Updated, Unchanged, Removed). When ready, click Apply Changes to Framer CMS. Your jobs are live!
Troubleshooting & FAQ
1. Error: "401 Unauthorized / Invalid API Token"
Ensure the API key was created in Teamtailor under Settings > Integrations > API keys with at least read permissions for jobs, departments, and locations. Also ensure you have selected the correct hosting region (e.g. EU vs North America).
2. How does the Reconciler handle closed jobs?
When a listing is archived or removed from Teamtailor, the plugin detects that it exists in your Framer collection but is absent from Teamtailor's active response. It automatically includes it in the "Removed" diff list and deletes it from Framer so your live career page remains clean.
3. Can I use the plugin across multiple collaborators?
Yes! All collection schema and mappings are stored inside your Framer Managed Collection configuration. For privacy and compliance, license keys and sensitive API tokens remain safely stored in each collaborator's local browser storage.