> ## Documentation Index
> Fetch the complete documentation index at: https://kardow.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Put your jobs on any website

> Show your live job listings on your own website with one line of code. People browse and apply right there. No coding needed.

The jobs widget puts your live job listings on any website. Visitors see your
open roles and apply right on the page, without going anywhere else. New jobs
appear automatically, and every application still lands in your Kardow dashboard.

<Info>
  **The one thing to know:** the jobs show up wherever you paste the code. It works
  exactly like embedding a YouTube video, paste the snippet where you want it, and
  it appears there. That's the whole idea.
</Info>

## Get your code

You need one line of code. The easiest way to get it, already filled in for a
specific company, is from your dashboard:

<Steps>
  <Step title="Open Companies">
    In your Kardow dashboard, go to **Companies**.
  </Step>

  <Step title="Click the embed icon">
    Find the company, and click the small **`</>`** icon on their row.
  </Step>

  <Step title="Copy the code">
    A window opens with the code ready to go. Click **Copy**. You can click
    **Preview** first to see exactly which jobs will show.
  </Step>
</Steps>

Your copied line looks like this:

```html theme={null}
<script src="https://your-board.com/embed.js" data-company="acme-inc" async></script>
```

To show **all** of your jobs instead of one company's, use the same line without
the `data-company` part.

## Add it to your website

Pick your website builder and follow the steps. In every case, you are just
pasting that one line where you want the jobs to appear.

<Tabs>
  <Tab title="WordPress">
    <Steps>
      <Step title="Edit your page">
        Open the page where you want the jobs (for example, your Careers page).
      </Step>

      <Step title="Add a Custom HTML block">
        Click the **+** button and choose **Custom HTML**. Drag the block to the
        exact spot you want the jobs, between your other content.
      </Step>

      <Step title="Paste and update">
        Paste your line of code into the block and click **Update**. Done.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Squarespace">
    <Steps>
      <Step title="Edit your page">
        Open the page and click where you want the jobs.
      </Step>

      <Step title="Add a Code block">
        Add a **Code** block, and paste your line of code into it.
      </Step>

      <Step title="Save">
        Click **Save**.
      </Step>
    </Steps>

    <Note>Code blocks need a paid Squarespace plan (Business or higher).</Note>
  </Tab>

  <Tab title="Wix">
    <Steps>
      <Step title="Add an embed">
        Click **Add** → **Embed Code** → **Embed HTML**.
      </Step>

      <Step title="Paste your code">
        Paste your line of code into the box.
      </Step>

      <Step title="Size and place the box">
        Drag the embed box to where you want it and set its height (Wix uses a
        fixed-size box, so give it enough room, for example 700 pixels).
      </Step>
    </Steps>
  </Tab>

  <Tab title="Webflow">
    <Steps>
      <Step title="Drag an Embed element">
        Drag an **Embed** element to the spot you want the jobs.
      </Step>

      <Step title="Paste and publish">
        Paste your line of code, then publish your site.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Plain HTML">
    Paste your line of code into your page's HTML, exactly where you want the
    jobs to appear:

    ```html theme={null}
    <h2>Open positions</h2>
    <script src="https://your-board.com/embed.js" data-company="acme-inc" async></script>
    ```
  </Tab>
</Tabs>

<Tip>
  Want the jobs in one exact spot but can only add the code to your whole site
  (some themes and plugins work that way)? Put an empty box where you want the
  jobs, and point the code at it:

  ```html theme={null}
  <div id="my-jobs"></div>
  <script src="https://your-board.com/embed.js" data-company="acme-inc" data-target="#my-jobs" async></script>
  ```
</Tip>

## How it looks

The widget automatically matches **your** brand, your colors, logo, and fonts,
straight from your Kardow settings. There is nothing to style. If you change your
board's look later, every website you embedded it on updates too.

## Where the applications go

Everything works like a normal application: it lands in your Kardow dashboard,
with the resume and any custom questions. The only difference is it's labeled
**Widget** and records which website it came from, so you can see how many
applications each site is sending you.

## Fine-tuning (optional)

You can ignore all of this. The one line already works. But if you want to
filter the jobs or change the layout, add any of these to the code:

<Accordion title="Optional settings">
  | Add this        | What it does                       | Example                              |
  | --------------- | ---------------------------------- | ------------------------------------ |
  | `data-company`  | Show only one company's jobs.      | `data-company="acme-inc"`            |
  | `data-category` | Show only certain categories.      | `data-category="engineering,design"` |
  | `data-location` | Show only certain locations.       | `data-location="beirut"`             |
  | `data-job-type` | Show only certain job types.       | `data-job-type="full-time"`          |
  | `data-remote`   | Show only remote jobs.             | `data-remote="true"`                 |
  | `data-limit`    | How many jobs per page (up to 50). | `data-limit="8"`                     |
  | `data-search`   | Hide the search box.               | `data-search="false"`                |
  | `data-height`   | Starting height in pixels.         | `data-height="700"`                  |
  | `data-target`   | The box to place the jobs into.    | `data-target="#my-jobs"`             |

  For example, this shows the 6 most recent engineering jobs, with no search box:

  ```html theme={null}
  <script
    src="https://your-board.com/embed.js"
    data-category="engineering"
    data-limit="6"
    data-search="false"
    async
  ></script>
  ```
</Accordion>

## Good to know

<Warning>
  **To test it, use your real website, or open `https://your-board.com/embed` in a
  browser.** That address is the widget's content.

  Do not test it inside an online code sandbox or an AI preview tool. Those block
  embedded content, so the widget will look broken when it is not. It works fine on
  real websites (WordPress, Squarespace, Wix, Webflow, Shopify, or plain HTML).
</Warning>

* **Applying never makes people leave the website.** They apply right there in a
  pop-up. They stay on your customer's site the whole time.
* **It works on any website** where you can paste a snippet.
* **Nothing to maintain.** New jobs appear automatically, closed jobs disappear.