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

# Reusable Backgrounds

> Create a consistent look and feel across multiple letters by providing backgrounds for letterheads, logos, footer information and branding.

<Tip>
  When directly providing text/HTML-formatted content for your letters, applying a background can make your letter look more professional and polished.
</Tip>

## Uploading a Background

Backgrounds can be uploaded directly from the [Intelliprint dashboard](https://dashboard.intelliprint.net/backgrounds), or via the API.

You can upload backgrounds as PDF or Word files.

<CodeGroup>
  ```javascript Node.js SDK theme={null}
  import Intelliprint from 'intelliprint'

  const ip = new Intelliprint('your-api-key-here')

  import fs from 'fs'

  const bg = await ip.backgrounds.create({
    file: fs.createReadStream('path/to/my/background.pdf'),
    name: 'Company Letterhead'
  })

  console.log(`Background created: ${bg.id}`)
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.intelliprint.net/v1/prints \
    -H 'Authorization: YOUR_API_KEY' \
    -F 'file=@path/to/my/background.pdf' \
    -F 'name=Company Letterhead'
  ```
</CodeGroup>

## Using a Background in a Print Job

You can provide two distinct backgrounds in a print job, `background.first_page` and `background.other_pages`. The `background.first_page` is applied to only the first page of the letter, and `background.other_pages` is applied to all the other pages in a letter.

Typically, you would use the `background.first_page` for a letterhead, and `background.other_pages` for a continuation design or footer information.

<CodeGroup>
  ```javascript Node.js SDK theme={null}
  import Intelliprint from 'intelliprint'

  const ip = new Intelliprint('your-api-key-here')

  const printJob = await ip.prints.create({
    background: { // [!code ++]
      first_page: 'bg_1234567890', // [!code ++]
      other_pages: 'bg_1234567890' // [!code ++]
    }, // [!code ++]
    // ...Other properties.
  })

  console.log(`Print job created: ${printJob.id}`)
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.intelliprint.net/v1/prints \
    -H 'Authorization: YOUR_API_KEY' \
    -F 'background.first_page=bg_1234567890' \
    -F 'background.other_pages=bg_1234567890' \
  # Provide the other properties of the print job.
  ```
</CodeGroup>
