---
title: "Set up an email placement"
description: "Produce the email-safe image and click URLs for a newsletter — the Email tab's image + click code, Creative URL and Landing page URL, the serving Domain and default parameters that rebuild them, the rand merge tag, and what to check when the newsletter shows the same banner on every open."
type: "howto"
audience: [network-manager, admin]
keywords: [email placement, newsletter, creative URL, landing page URL, image + click code, img src, a href, Email tab, serving domain, default parameters, rand, merge tag, cache busting, no JavaScript]
ui_path: "Account → Publishers → site → zone → placement → Ad tags & API → Email"
---

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.

# Set up an email placement

## What it is and why

An **Email** placement produces email-safe image and click URLs: an `<a><img>` snippet to paste
into the template, with the image picked at open time and no JavaScript involved. The URLs exist
once the placement is saved, and are rebuilt whenever its serving domain or default parameters
change. The other specialist types are on
[Application, email and click-through placements](https://epom.com/ad-server/docs/guides/inventory/placement-mobile-email-other.md); email ad
codes at site level are on [Email ad codes on a site](https://epom.com/ad-server/docs/guides/inventory/site-email-codes.md).

**Example.** A publisher's weekly newsletter carries a 600×200 banner. It is an **Email
Placement** whose Email tab gives an `<a><img>` snippet to paste into the template — the image is
picked at open time, no JavaScript runs — and a merge tag on the `rand` parameter makes each open
a fresh request.

## Typical scenarios

| You want | Create | Then hand over |
|---|---|---|
| An image + link in a newsletter | **Email Placement** (a size is required) | The `<a><img>` block from the **Email** tab, or the Creative URL and Landing page URL separately |
| A newsletter served from a second domain of the network | **Email Placement**, **Domain** picked on the **Settings** tab | The rebuilt URLs |

## Step by step

Start from a saved placement of this type ([create one](https://epom.com/ad-server/docs/guides/inventory/placements-create.md)).

1. Create and save the placement — the integration URLs exist only after the first save. Open
   the **Ad tags & API** card and its **Email** tab:
   - the **image + click code** block — a ready-to-paste `<a><img>` snippet;
   - **Creative URL** — the `<img src>` beacon, on its own copyable field;
   - **Landing page URL** — the `<a href>` click target, on its own copyable field.

   ![Email tab with the code block and the read-only creative and landing page URLs](https://epom.com/docs-images/ad-server/placement-mobile-email-other/email-urls.webp)

2. If your network serves from several domains, pick the **Domain** on the **Settings** tab —
   the URLs are rebuilt for the chosen domain (it saves immediately).

3. Any [default parameters](https://epom.com/ad-server/docs/guides/inventory/ad-tags-and-api.md) you set in **Settings** are baked into all
   three, and they refresh in place when you change a default or the domain.

4. Paste the block into the email template. If your email platform supports merge tags, put one
   on the `rand` parameter so each open is a fresh request.

## Caveats and exceptions

**Email clients execute no JavaScript**, so an email placement can only rotate whatever renders as
a static image at open time. Both URLs are read-only — you never edit them, only copy. Add a
cache-busting merge tag for the `rand` parameter if your email platform supports it.

**Size is required** on an Email placement, as on a Site placement; the other types leave it
optional.

Who can do this, and the Preview button (an Email placement has one), are on
[Application, email and click-through placements](https://epom.com/ad-server/docs/guides/inventory/placement-mobile-email-other.md#caveats-and-exceptions).

## Not working?

| Symptom | Check | Where |
|---|---|---|
| The Email tab is missing after creation | The URLs exist only after the first save | **Save**, then open **Ad tags & API → Email** |
| The newsletter shows the same banner on every open | Email clients run no JavaScript; rotation happens per request | Put a merge tag on the `rand` parameter |
| The email URLs changed since you copied them | You changed the **Domain** on the Settings tab or a default parameter; the URLs were rebuilt | Re-copy from the **Email** tab |

The symptoms common to all three types (the Settings tab missing on a share) are on
[Application, email and click-through placements](https://epom.com/ad-server/docs/guides/inventory/placement-mobile-email-other.md#not-working).

## Reference

The three outputs and the Domain picker:
[Email placement outputs](https://epom.com/ad-server/docs/guides/inventory/placement-mobile-email-other.md#email-placement-outputs) on the hub;
the REST call that creates or updates an email placement:
[Over the API](https://epom.com/ad-server/docs/guides/inventory/placement-mobile-email-other.md#over-the-api).

## Related

- [Application, email and click-through placements](https://epom.com/ad-server/docs/guides/inventory/placement-mobile-email-other.md)
- [Set up an application placement](https://epom.com/ad-server/docs/guides/inventory/placement-mobile-email-other-application.md)
- [Set up a click-through placement](https://epom.com/ad-server/docs/guides/inventory/placement-mobile-email-other-click-through.md)
- [Email ad codes on a site](https://epom.com/ad-server/docs/guides/inventory/site-email-codes.md)
- [Email newsletter ads](https://epom.com/ad-server/docs/use-cases/email-newsletter-ads.md)
- [Ad tags, invocation codes and the API](https://epom.com/ad-server/docs/guides/inventory/ad-tags-and-api.md)