Getting started with Ruutly

Step 1.

The first step in getting started with a Ruutly integration is to send us an email at and let us know that you’re ready to get started. Once we hear from you, we’ll go ahead and activate a job listings page and postings pages for your company complete with the assets you want to see there and give you instructions to have your career site point to your Ruutly enable job posts.

We’ll send you a confirmation email as soon as your account has been activated and you can then go ahead and signup for an account at


NOTE: to use Ruutly, you must be using a custom-designed job posting OR a Ruutly-designed job posting. We can get you setup with these for no additional cost outside of a Ruutly subscription.

Step 2.

After signing into your account, navigate to the settings menu, located by clicking your name in the top right of the screen in the main navigation for Ruutly.


In the settings menu, select “INTEGRATIONS” and click the radio button beside “Greenhouse” and enter your Greenhouse Board Token into the text field on the right side. (Note: If you’re not sure what your Greenhouse Board Token is, in your Greenhouse account, go to Configure >> Job Board and scroll down to the section for the URL of your job board. In most cases this URL will be The section you need from Greenhouse for your board token is the “companyname” part of the URL. Simply copy it from your Greenhouse account and paste it into the text field for Greenhouse Board Token text field in Ruutly.

Click Update in your Ruutly Integrations Settings to save your Greenhouse Board Token.


Now that your company Greenhouse Board has been connected to Ruutly, your live requisitions will be added to a queue of job posts that need content before they can be added automatically to those job posts.


Step 3.

Before going in and creating your Ruutly content, it’s best to spend some time putting default content into your library. This is done via the Library in the main Ruutly navigation at the top of the page.

Click ‘Library’ on the navigation and you can begin adding universal content for your Ruutly account. You can add all library content into a single team or if you’re hiring for a variety of teams/business segments, you can add content for a specific team by adding the team first.

Content includes a brand color, logo, image and Ruut content. Again, this can be done on a team by team basis if you prefer.


Step 4.

Once you’ve added some content into your library and clicked ‘Save Defaults’ at the bottom of the page, click “Next Up” in the top navigation.

The next up section displays all of your live Greenhouse job posts that do not have Ruutly embedded in them. Don’t worry, those job posts are live on your career site, they simply don’t have Ruutly in them yet.


Choose a job post that you’d like to add Ruutly to by clicking ‘Create Ruut’. Doing this will bring you to the Ruut builder. This is where you will add all of the content to the Ruutly embed.



If you’ve selected a logo, brand color and logo, they should appear by default along with the title of the job post. If not, you can select the logo, background and highlight color here. And if the current job is for a specific team, you can select that team from the ‘Ruut Team’ dropdown and this will load only the content specific for that team.

Once you have the design of your Ruut where you want it to be, click next.

Step 5.

In this section you will spend your time getting the content into your Ruut.


The first thing you’ll notice is that most of the Summary section at the top is completed for you. This is all pulled directly from Greenhouse.

Below that, you’ll find the Ruutly content blocks. It should be noted that if you leave any of the summary blocks blank, they simply won’t appear when they’re published. It won’t leave blank white space on the finished product.

The first content block is the Requirements section. This is the first section candidates will see when they land on a Ruutly enabled job description. If you’e added Requirements to your library, you’ll notice that as you start to type in the text field, a dropdown will appear filled with your library content.

If you don’t have any Requirements in your library or would like to add custom content, simply type in the requirement, select an icon and move onto the next one. And again, if you choose only to have 3 or 4 Requirements, the “Add Requirement” text and placeholder icons will be removed when it’s published and the content will be centred.

Next up is the skills section, again, if you have skills set as ‘Default’ in your library, it will already appear in this section. If not or if you want to add custom content, simply start typing into the text fields to add your content to your Ruut.

The final content block is the “Why Your Company” section. This content is typically marked as default by most companies and will likely already be there. If not, go ahead and start adding the benefits, perks and culture of your company. You can also include YouTube videos in this section by copying a YouTube URL and pasting it into the video field.

Once your content is good to go, click Next.


Step 6.


The final section of the Ruutly builder is ‘Related Careers’. If you want to include related careers in your Ruut, simply add the details for those jobs here. Again, if you do not include content here, the bottom Relat Careers block will not appear when you publish your Ruut.

Once you’ve added (or skipped) Related Careers, click next.



Step 7.

On the final screen, select ’Save and Activate’. Because you have an integration configured, you do not need to embed it manually. If you’d like to save it for review, select ‘Save and Close’



Once you’ve Saved and Activated your Ruut, it will appear in the corresponding job post and begin collecting data from people viewing that posting and populating that data into your Ruutly dashboard.