Skip to main content

Inventory Overview

Manage your ad placements and how they're organized across your site.


What is inventory?

Your inventory consists of:

  • Ad slots — Individual ad placements (where ads appear)
  • Layouts — Collections of ad slots (which slots load on which pages)

A typical setup for a single site:

  • Homepage — layout Homepage loads header, sidebar, footer
  • Articles — layout Article Pages loads header, sidebar, incontent_1, incontent_2
  • Category pages — layout Category loads header, sidebar

Key concepts

Ad slots

An ad slot is a single ad placement — one location where an ad appears.

PropertyDescription
NameYour identifier (e.g., article_sidebar_top)
SizesAllowed dimensions (e.g., 300x250, 300x600)
SettingsLazy loading, refresh, floors

Learn more: Ad Slots →

Layouts

A layout is a collection of ad slots that load together on specific pages.

PropertyDescription
NameYour identifier (e.g., Article Pages)
TargetingWhich URLs this layout applies to
SlotsWhich ad slots are included

Learn more: Layouts →


How inventory works


Managing inventory

TaskWhereLink
View all ad slotsInventory → Ad SlotsView slots →
Create ad slotInventory → Ad Slots → AddCreate slot →
View all layoutsInventory → LayoutsView layouts →
Create layoutInventory → Layouts → AddCreate layout →

Best practices

Naming

Use consistent, descriptive names:

Ad slots: [page]_[position]_[number]
homepage_header_1
article_sidebar_top
category_incontent_1

Layouts: [page type] or [section]
Homepage
Article Pages
Sports Section

Organization

  • Start simple — Begin with core page types and expand
  • Group logically — Similar pages share layouts
  • Document — Keep notes on your slot purposes

Performance

  • Limit slots per page — 4-6 is typical
  • Use lazy loading — For below-fold slots
  • Reserve space — Prevent layout shift

Getting started

If you're setting up inventory for the first time:


Common questions

How many ad slots should I have?

There's no magic number. Consider:

  • User experience — Too many ads annoys users
  • Page layout — What fits naturally?
  • Revenue goals — More slots = more potential revenue, but diminishing returns

Most sites do well with 4-6 slots per page.

Can one ad slot be in multiple layouts?

Yes. An ad slot can be included in any number of layouts. This is common for slots like headers that appear across page types.

What if no layout matches a page?

No ads will load. Create a catch-all layout with a Regex match: .* page-path rule as a fallback, or ensure your layouts cover all page types.