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

# ENS Ads Placement Slugs: All 15 Ad Positions Listed

> ENS Ads placement slugs identify where ads appear on your page. Browse all 15 supported placements — header banners, sidebars, feeds, modals, and more.

A placement identifies where on a page an ad is displayed. ENS Ads uses placement slugs — short string identifiers — to connect campaigns to specific visual locations in your UI. When you fetch campaigns, you tell the API which placement you are filling, and the API returns campaigns that have been targeted to that slot.

<Tip>
  The `placement` parameter is required on every call to `GET /api/v1/campaigns/fetch`. Requests that omit it will receive a `400` error with the message `"placement parameter is required"`.
</Tip>

## Available placements

The table below lists every supported placement, its slug (the value you pass in the `placement` parameter), and where it appears on a page.

| Slug             | Name                  | Description                            |
| ---------------- | --------------------- | -------------------------------------- |
| `header_banner`  | Header banner         | Full-width banner at top of page       |
| `hero_section`   | Hero section overlay  | Overlay on main hero/featured section  |
| `sidebar_top`    | Sidebar — top         | Premium position in right/left sidebar |
| `sidebar_middle` | Sidebar — middle      | Mid-position in sidebar                |
| `sidebar_bottom` | Sidebar — bottom      | Bottom position in sidebar             |
| `article_inline` | Article inline        | Embedded within article content        |
| `article_top`    | Article top           | Above article headline                 |
| `article_bottom` | Article bottom        | Below article content                  |
| `feed_sponsored` | Feed — sponsored post | Native ad in content feed              |
| `feed_carousel`  | Feed — carousel       | Carousel/slider in feed                |
| `feed_between`   | Feed — between posts  | Between regular feed items             |
| `footer_banner`  | Footer banner         | Full-width banner at page footer       |
| `footer_top`     | Footer — top section  | Above footer content                   |
| `modal_overlay`  | Modal/popup           | Interstitial modal ad                  |
| `sticky_bottom`  | Sticky bottom bar     | Fixed bar at bottom of viewport        |

## Using placements in your request

Pass the placement slug as a query parameter when fetching campaigns:

```bash theme={null}
curl -X GET "https://ads.enslive.live/api/v1/campaigns/fetch?placement=header_banner&location=US&device=desktop" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

You can fetch campaigns for one placement per request. If your page renders multiple placements, make a separate request for each one.

## Placement categories at a glance

<AccordionGroup>
  <Accordion title="Page structure placements">
    These placements sit in fixed regions of the overall page layout:

    * `header_banner` — top of the page, maximum visibility
    * `footer_banner` — bottom of the page
    * `footer_top` — directly above the footer block
    * `sticky_bottom` — fixed to the bottom of the viewport while the user scrolls
    * `modal_overlay` — appears over page content as an interstitial
  </Accordion>

  <Accordion title="Sidebar placements">
    Sidebar placements fill a vertical column alongside main content. Three positions give you control over ad density:

    * `sidebar_top` — highest position, premium visibility
    * `sidebar_middle` — mid-column
    * `sidebar_bottom` — lowest position
  </Accordion>

  <Accordion title="Article placements">
    These placements are tied to editorial content pages:

    * `article_top` — above the article headline
    * `article_inline` — embedded within the article body
    * `article_bottom` — below the article
  </Accordion>

  <Accordion title="Feed placements">
    Feed placements blend into content streams and listing pages:

    * `feed_sponsored` — styled as a native sponsored post
    * `feed_carousel` — a swipeable carousel/slider unit
    * `feed_between` — inserted between organic feed items
  </Accordion>

  <Accordion title="Hero placement">
    * `hero_section` — overlaid on the main hero or featured image of the page; high-impact, often used on homepages or landing pages
  </Accordion>
</AccordionGroup>

<Note>
  Always render the campaign in the placement you requested. Displaying a campaign in a different slot than the one used to fetch it produces inaccurate targeting data and may violate advertiser campaign settings.
</Note>
