Admin & Organization Settings
Job Board Setup
Embedding Ashby Job Boards in an external Careers Page
5 min
customers often wish to use alternatives to the provided ashby hosted job boards (https //jobs ashbyhq com) to provide a more branded experience, ashby supports embedding the ashby job board directly in their own careers website companies using this approach https //www ycombinator com/careers embedding ashby job board in an external careers page embedding your ashby job board directly in your careers page only takes a few minutes to setup first, you'll need to update some settings in the theme section of the app under job board embedding check the allow job board embedding option after allowing job board embedding, you can then provide your custom jobs page url below once you have set your custom jobs page url , you’ll see instructions on how to embed your job board follow those instructions to edit your careers page and embed your job board place this tag on your page where you want the ashby job board to be embedded \<div id="ashby embed"> add this script tag at the end of your page’s html body tag \<script src="https //jobs ashbyhq com/\[fill in job board slug here]/embed?version=2">\</script> adding css to your job board embed in the allowed custom css urls section, you can determine the urls that can be used to load external css into your embedded job board add your custom css url or urls into the allowed custom css urls field, then click submit to add them please note that one url should be entered per line and that urls have to match exactly to that of where the css file is hosted if this field is left empty, then css cannot be configured on the embedded job board for further information, please check out https //www ashbyhq com/job board embed examples once you've added your allowed custom css urls, please ensure they are added to your iframe script too it should look something like the following \<div id="ashby embed">\</div> \<script> window ashby = { settings { ashbybasejobboardurl "https //jobs ashbyhq com/ashby embed demo org" customcssurl "https //www ashbyhq com/job board example css/full job board css" } } \</script> if the css urls are not included within the script tag, then the css will not be applied to your embed embedding a single application the embed script also supports embedding a single application to do this, you can add the following attributes to the \<div id="ashby embed"> tag data jid="\<jid>" with this attribute set, the embed code will always load that specific job post, identified by the “jid” (e g “45134452 f53b 4d4c 915e 4a4615fb6c93", for a job post with the url https //jobs ashbyhq com/ashby/45134452 f53b 4d4c 915e 4a4615fb6c93) data tab="application" with this attribute set, the embed code will load the above application on the application tab (as opposed to the job description tab) data nochrome="true" with this attribute set, the embed code will hide navigation, title, and sidebar “chrome ” combine this with other attributes to embed an application form that feels like it’s a part of your site other options for other ways to add your jobs board to your external careers page, please see faq when i decline cookies on my careers page, my embedded job board doesn’t show up why? some cookie banner tools, like termly, can block the iframe from showing up on your careers page why am i receiving a jobs ashbyhq refuses to connect error on my career page? the refused to connect message usually means the embed can’t complete its origin check a few quick tweaks typically resolve it ensure you are using this exact embed tags provided on the https //app ashbyhq com/admin/organizational settings/theme page remove any editor wrappers ensure the code isn’t wrapped by a wysiwyg in \<p>, \<br>, or \<span> tags the \<div id="ashby embed">\</div> and the \<script> tag should be inserted as raw html in the page template or a raw/html block (and not inside a paragraph)