---
title: "Sites reference"
description: "Every Basic info field of a site, the site-level cards and what each controls, the header actions and the REST calls — the companion to the Create and edit a site guide."
type: "reference"
audience: [network-manager, publisher, admin]
keywords: [sites reference, site fields, inventory type, developer website, app bundle, site URL, category, private, collect cookies, monthly impressions, supply chain, seller ID, site cards, pre-targeting, OpenRTB integration, revenue share, bid floor, CPM threshold, matching rules, piggybacks, payments, sharing settings, zones counter, placements counter, create user and share, email ad tags, delete site, sites REST API]
ui_path: "Account → Publishers → site"
---

Fetch the complete documentation index at: https://epom.com/ad-server/docs/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Sites reference

The companion to [Create and edit a site](https://epom.com/ad-server/docs/guides/inventory/sites.md), which has the steps, the caveats and the
fix-it checklist; this page holds every Basic info field, the site-level cards, the header
actions and the REST calls.

## Options and fields (Basic info)

| Field | What it does | Default | Notes |
|---|---|---|---|
| Name | Site display name across trees, grids, reports | — | Required, max 128. Not editable on masked shares |
| Status (Active/Inactive) | Master on/off for the whole site subtree | Active | Shown only if your role can switch sites on and off |
| Category | Publisher categories used by auto-linking and Rules | none | Changing it triggers the auto-link question (see caveats). With a read-only categorization grant the field is visible but locked |
| Inventory type | Website ⇄ App | Website | App adds the App bundle field and renames Site URL to Developer website |
| Site URL / Developer website, App bundle | The property address (for an app, the developer website from its store page) / package id | — | Max 255. A URL with spaces saves with a warning toast; a URL with **no scheme** (`example.com`) is rejected outright |
| Additional fields | Network-defined custom fields | — | Appear only if your network configured them |
| Private *(Advanced settings)* | Marks the site private | off | Shown only if your role allows it |
| Collect cookies *(Advanced settings)* | Per-site cookie collection toggle | off | Shown only if your role allows it; not a network switch |
| Email / Description | Contact and notes | — | Not rendered at all on masked shares |
| Monthly impressions / Monthly visitors | Traffic estimates picked from preset ranges | — | Informational |
| Supply chain *(own section, before Additional information)* | The site in your `sellers.json` and in the supply chain sent to buyers: **Seller ID** (empty = the generated ID, shown greyed out), **Seller type** (Publisher / Intermediary / Both), **List in sellers.json** (a switch, off by default — sites are opted in one by one), **Confidential** beside it (listed by seller ID and type only; ticked and locked on a site with masked inventory), and the site's **ads.txt** block — the lines the publisher must publish, grouped by source, with Copy, Download, the nightly check result and **Re-check now**; the **Header-bidding partners** in the site's active tags, one row each with its bidder code and whether the file has its line; and **Additional ads.txt lines** — the saved lines, then a box to paste more — for a partner that sells the site but is not an advertiser. Collapsed, the section's header sums up whether the site is listed in sellers.json and the last ads.txt check | see each field | The seller ID is editable by anyone who can edit the site. The **Site Supply Chain (sellers.json, ads.txt / app-ads.txt)** permission, off for every role until granted, governs everything else, grouped under **sellers.json & ads.txt**: without it only the seller ID shows; read-only shows the group locked, marked **Read-only**. Header-bidding tags name you as the seller only when the seller ID is filled in; bid requests to DSPs carry it only once sellers.json is published. Not shown on a masked share, and a save or API update through one leaves the sellers.json fields as they were. See [Supply chain and sellers.json](https://epom.com/ad-server/docs/guides/inventory/supply-chain-and-sellers-json.md) |
| Created | Creation date | — | Read-only, last field in Additional information |

## Site-level cards

The cards below Basic info follow the same pattern: a switch turns the feature on/off, and the
**Features** rail on the side mirrors the switches.

| Card | What it controls |
|---|---|
| Pre-targeting | Traffic filters applied to every placement under the site — see [Pre-targeting and blocking](https://epom.com/ad-server/docs/guides/targeting/pretargeting-blocking.md) |
| OpenRTB integration | IAB categories, blocked IAB categories and the OpenRTB publisher id sent in bid requests — see [how the site, zone and placement lists combine](https://epom.com/ad-server/docs/guides/inventory/placement-openrtb.md#how-the-placement-combines-with-its-site-and-zone) |
| Revenue share | Per-advertiser revenue-share percentages |
| Pricing | Publisher payment model and per-country prices |
| Bid floor | Minimum acceptable price, per country |
| Limits | Impression/click/conversion caps for the site — see [Limits](https://epom.com/ad-server/docs/guides/delivery/limits.md) |
| Per conversion action limits | Caps per conversion action |
| CPM Threshold | Per-country minimum CPM the publisher is guaranteed — a revenue floor for reporting/payouts and the fallback RTB bid floor; direct campaigns still serve below it — see [Site CPM threshold](https://epom.com/ad-server/docs/guides/delivery/cpm-threshold.md) |
| Matching rules | Automatic banner-matching rules scoped to this site |
| Matched banners | Read-only cascade of the advertisers → campaigns → banners the rules currently match |
| Piggybacks | Third-party tracking pixels fired with site traffic — see [Piggybacks](https://epom.com/ad-server/docs/guides/conversions/piggybacks.md) |
| Video creative requirements | The publisher's video spec: an uploaded video that misses it is not served on this site — see [Check video creatives against a publisher's spec](https://epom.com/ad-server/docs/guides/inventory/video-creative-requirements.md) |
| Payments | Read-only publisher payout history by year |
| Sharing settings | Give other users access to this site — see [Shares](https://epom.com/ad-server/docs/guides/collaboration/shares.md) |

## Header actions

- **Zones counter** — the title shows `(zones: N)` and links to the zones list.
- **Placements counter** — `(placements: N)` next to it opens every placement of the site in one
  list, across all its zones. It is the full placements grid narrowed to this site (with the
  **Site** column dropped), **Filter by** offering *Zone* and *Placement*, and a
  **Zones | Placements** switch above the grid. Both counts exclude deleted entities. There is
  no **Add placement** button — a placement belongs to one zone, so create it from the zone.
- **Approval badge** — **Pending** or **Rejected** next to the eyebrow when your network reviews
  sites; an approved site shows no badge.
- **Add new zone** — hidden on masked or non-editable shares.
- **Actions → Create user & share** — creates a statistics-only user for this site: enter
  username, email and role. The address receives an invitation with a single-use set-password
  link, not a password. See [Account users](https://epom.com/ad-server/docs/guides/collaboration/account-users.md).
- **Actions → Email ad tags** — the site's placement tree with one checkbox per available tag
  type for each placement (each placement's default tag type pre-checked); recipients, subject
  and body; optionally as a single file. See [Email ad codes on a site](https://epom.com/ad-server/docs/guides/inventory/site-email-codes.md).
- **Actions → Delete this site** — cascades to zones and placements; restorable for 90 days (see
  caveats).

## Over the API

The ads.txt block is `GET /rest-api/sites/{siteId}/ads-txt` (lines and last check) and
`POST /rest-api/sites/{siteId}/ads-txt/check` (queue a re-check). The Payments card is
`GET /rest-api/site/{siteId}/payouts.do`; booking and removing payouts is described in
[Finances, fees and referral billing](https://epom.com/ad-server/docs/guides/admin/finances-and-billing.md#over-the-api). A deleted
site is restored with `POST /rest-api/deleted-entities/{type}/{id}/restore`. The site itself is
created and edited with `POST /rest-api/sites/update.do` — see the
[Sites API reference](https://epom.com/ad-server/docs/api/sites.md).

## Related

- [Create and edit a site](https://epom.com/ad-server/docs/guides/inventory/sites.md)
- [Work with zones](https://epom.com/ad-server/docs/guides/inventory/zones.md)
- [Create a placement](https://epom.com/ad-server/docs/guides/inventory/placements-create.md)
- [Supply chain and sellers.json](https://epom.com/ad-server/docs/guides/inventory/supply-chain-and-sellers-json.md)
- [Privacy signals and ads.txt](https://epom.com/ad-server/docs/guides/inventory/privacy-and-ads-txt.md)
- [Shares](https://epom.com/ad-server/docs/guides/collaboration/shares.md)