Based on user feedback about limited formatting options and inconsistencies between the job editor and careers site, along with insights from our technical research, we’re switching from our old text editor, Redactor, to a new one, ProseMirror. This change enables greater customizability and improved predictability.
You may have already used ProseMirror in other parts of our app, such as candidate profiles (notes), talent pools, or the ‘highlights’ fields in jobs.
What changed? 📋
“Old” text editor:
“New” text editor:
You can notice several changes:
Reorganized formatting options: We’ve simplified the layout by grouping similar options, making it easier to navigate.
Quick-use features: Highlight text to access commonly used options instantly.
Enhanced color customization: We’ve replaced the limited color palette with a full-spectrum color picker, allowing you to align more closely with your company branding.
Simplified text sizes: Text size is now managed through fixed headings and body text options, ensuring consistency between the job editor and the careers site.
Additionally, based on usage data, we’ve decided to discontinue support for:
File attachments (e.g., PDFs)
Full-screen mode
Custom HTML editing
ℹ️ If you previously relied on any of these options, we’ve suggested some alternative solutions for you to consider.
What are the benefits of the new text editor? ✨
Here are some of the key advantages where new text editor outperforms the previous one:
Customizability: the new editor offers significant flexibility. It allows us to introduce new features quickly and improve the user experience. In the past, adding new features to the old editor was challenging, and users had to rely on custom HTML to achieve specific results.
That being said, we can now introduce more plugins, which opens the door to additional formatting options such as columns, toggle lists, dividers, and more.
You can share your ideas on Canny, under this Canny post, and we'll consider your suggestions as potential improvements!
Branding alignment: the new editor makes it easier to align with their branding by offering an unlimited color palette—something that has been requested a number of times in the past.
Predictability and stability: the new editor functions more predictably, leading to a smoother writing and formatting experience, and reducing the number of potential issues.
What if I was using one of the discontinued options? 🤔
If you were using any of the features we no longer support, here are some alternative solutions:
Uploading files (e.g., PDFs) to job offers
Instead of attaching files, you can upload them online (e.g., using a file-sharing platform) and include the link in the job description.Using the ‘full screen’ option
Our text fields automatically expand as you add more content, providing ample space for even longer descriptions. Additionally, you can preview your job post at any time by selecting the ‘Preview’ option from the top bar.Adding custom HTML to job descriptions
Detailed guidance on this topic is provided below.
Supporting your transition away from custom HTML
We aim to deliver intuitive, accessible solutions that benefit all users while ensuring consistency across our products. For the 3% of users relying on custom HTML, we’re committed to a smooth transition.
Our goal is to empower users to create jobs using the text and formatting tools available in the job editor while shifting the visual design elements to the careers site. We want to eliminate the need for custom code to achieve professional results and instead provide an accessible, user-friendly solution for everyone.
Here are some alternative solutions we currently offer, along with upcoming features:
Current Alternatives To Custom HTML
Adjusting video player sizes
You can now resize videos directly within the job editor:Using custom hex/RGB font colors
Our new color picker allows you to select any color, offering more flexibility in matching your branding.
Visually enhancing job elements (e.g., Benefits)
To display elements like benefits as icons or illustrations, we recommend adding them as images in your job description.
🆕 Styling a job using CSS with custom HTML classes
If you'd like to style the job with your own code, you can edit class attributes and apply them to elements like <p>, <h*>, <ul>, and more. Here’s how:Edit HTML classes:
Add or modify class attributes for the desired elements in your job description:Define class names:
Specify the class names you'd like to use for styling:Apply custom CSS:
Go to your CareersHub Settings and use the defined classes to style the job with your custom CSS:
Upcoming Solutions
We’re currently working on enabling the following options for you:
Adding ‘columns’ as a formatting option, so you can further adjust the job layout
If you would like us to introduce more formatting options, share your suggestions on Canny. Our personal favourites are: ‘banner’ text, line separator, or toggle list.
Last but not least, we’re also planning to introduce dedicated sections within jobs, such as ‘Benefits’ or ‘About the Team/Company,’ based on your feedback from: Job Description Structure Improvements (and similar posts). You’ll have the flexibility to work with a single section or multiple ones, depending on your preference.
Gradual Transition
When implementing the new editor, we aimed to avoid disruptions and gave our users the flexibility to update their jobs at their own pace. This allows for a gradual and manageable transition. However, if you prefer not to handle the update manually, you can wait until the specified due date, and we will automatically migrate your active jobs for you.
Need Help? ☎️
If you further have questions or need assistance, please don’t hesitate to contact our support team or your dedicated customer success representative.