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

# Media library

> Upload and reuse images and videos across emails, popups and your brand kit, generate images with AI, and recover deleted files from the 30 day trash.

The media library is where every image and video you use in Senderz is stored. Upload a file once, then reuse it in any email, popup or brand asset.

It lives at **Media & Brand** in the sidebar, under Content. The page has two tabs:

<CardGroup cols={2}>
  <Card title="Media" icon="images">
    Your uploaded files. Images, videos and the trash.
  </Card>

  <Card title="Brand" icon="palette">
    Your brand kit. Logo, colours, fonts, buttons, voice.
  </Card>
</CardGroup>

Inside the **Media** tab there are three lists: **Images**, **Videos** and **Trash**.

<Note>
  Brand font files you upload from the Brand tab are stored in the same library,
  but they do not appear under Images or Videos. If you delete one it does show
  up in the Trash.
</Note>

## Uploading

You can add files three ways, and all three accept several files at once.

<Steps>
  <Step title="Open the Images or Videos list">
    The list you are on decides which file types are accepted.
  </Step>

  <Step title="Add your files">
    Press **Upload media**, drag files straight onto the grid, or use the
    **Add more** tile at the end of the grid.
  </Step>

  <Step title="Watch each file upload">
    Every file gets its own card with a live progress bar. If one fails, that
    card offers **Retry**. **Dismiss** removes it from the queue.
  </Step>
</Steps>

Files that fail the type or size check are skipped with a message telling you how many were skipped and why. The rest still upload.

### Accepted types and size limits

| List   | Accepted files      | Maximum size   |
| ------ | ------------------- | -------------- |
| Images | PNG, JPG, GIF, WebP | 15 MB per file |
| Videos | MP4, WebM, MOV      | 25 MB per file |

<Warning>
  SVG and AVIF files are not accepted by the uploader. Convert them to PNG or
  JPG first.
</Warning>

## Images are optimised on upload

Senderz shrinks images as they arrive, so a heavy photo does not slow down your emails. When a file is made meaningfully smaller you get a confirmation showing the size before and after.

What happens:

* Images wider than 1320 pixels are scaled down to that width. Smaller images are never enlarged.
* The image is re-encoded and quality is stepped down until the file is around 280 KB, with a floor so quality never collapses.
* Photos without transparency come out as JPG. Images with real transparency come out as PNG.
* The file extension in the library changes to match, so `banner.webp` may become `banner.jpg`.
* **GIF files are left completely alone**, so animation is preserved.
* If the re-encoded version would not be smaller, your original is kept as it is.

The size shown on the card is the stored size, which is why it is often smaller than the file you picked.

## Using a file

Each card in the grid has a menu with:

| Action              | What it does                                                    |
| ------------------- | --------------------------------------------------------------- |
| **Rename**          | Changes the display name only. The file's link does not change. |
| **Copy CDN link**   | Copies the file's public URL to your clipboard.                 |
| **Open in new tab** | Opens the file itself in your browser.                          |
| **Delete**          | Moves the file to the trash.                                    |
| **Restore**         | Only in the Trash. Puts the file back in its list.              |

An **AI** badge marks images that were generated with AI rather than uploaded.

### Placing a video in an email

Videos are not offered in the image picker. To use one in an email, copy its link from the library, then paste it into the **Video URL** field on a video block. The block's thumbnail is picked separately, through the normal image picker.

## The image picker

Anywhere Senderz needs an image, you get the same **Select image** dialog. You do not have to visit the media library first.

<Tabs>
  <Tab title="Image library">
    Every image in your library. Search by name, switch between grid and list
    view, and toggle **Show AI-generated images** on or off. Images only, so
    videos and fonts never appear here.
  </Tab>

  <Tab title="Upload image">
    Drag in or select a file. It uploads straight into your library and is
    selected for you.
  </Tab>

  <Tab title="Generate">
    Describe an image and have AI make one. See below.
  </Tab>

  <Tab title="Import URL">
    Paste a direct link to an image hosted somewhere else, with a preview
    before you commit. This tab appears on the brand logo only.
  </Tab>
</Tabs>

Where the picker appears:

* **Email builder**: image blocks, image rows, video block thumbnails, and the template background under Styles.
* **Popups**: image elements, side and background images, the popup logo, the teaser image, game prize art and education blocks.
* **Brand kit**: your brand logo.

<Info>
  A file chosen through **Import URL** is not copied into your library. It stays
  on the other server, so if that link ever breaks, your email or popup breaks
  with it. Uploading is safer.
</Info>

## Generating an image with AI

The **Generate** tab writes an image from a text description and saves it into your library.

<Steps>
  <Step title="Connect your own AI key">
    Image generation runs on your own AI provider account, set up in
    **Settings** under AI provider. If no key is connected the tab tells you so
    and links you there. See [AI provider](/en/integrations/ai-provider).
  </Step>

  <Step title="Describe the image">
    Up to 1000 characters. Be specific about subject, style and lighting.
  </Step>

  <Step title="Pick an aspect ratio">
    Square, Portrait or Landscape.
  </Step>

  <Step title="Generate, then use it">
    Regenerate as many times as you like. Press **Use this image** when you are
    happy. It is already saved to your library, tagged with the AI badge.
  </Step>
</Steps>

<Warning>
  **Only OpenAI and Gemini can generate images.** If your AI provider is Claude,
  the tab tells you that provider cannot make images and offers to take you to
  settings. A custom provider works as long as it is not Anthropic compatible.
  Everything else in Senderz AI still works on Claude, image generation is the
  one exception.
</Warning>

Generated images count against your own AI provider bill, not your Senderz plan.

## Deleting and the trash

Deleting is reversible. A deleted file moves to the **Trash** list, and each card there shows how many days it has left.

* Files stay in the trash for **30 days**.
* **Restore** puts the real file back, not a placeholder. Its link works again exactly as before.
* After 30 days the file is permanently removed and cannot be recovered.

<Warning>
  A file in the trash is no longer served. Any email, template or popup still
  pointing at that link will show a broken image until you restore it. The
  delete confirmation says so. Check where a file is used before you delete it.
</Warning>

If you delete the image that is set as your brand logo, the logo is cleared from your brand kit at the same time. Restoring the file does not put it back as the logo, so set it again from the Brand tab.

Every delete, restore and permanent removal is written to your workspace audit log with the name of the person who did it.

### Editing a template never deletes a file

Swapping an image in the email builder, clearing one, or deleting a whole block leaves the original file untouched in your library. The only way a file leaves the library is if someone deletes it from the media library on purpose.

## How files are served

Files are served from the Senderz asset CDN over a public HTTPS link. Two things follow from that.

**The link is public.** It is long and unguessable, so it will not be found by browsing, but anyone you give it to can open the file without signing in. Do not upload anything you would not be comfortable sharing.

**The link never changes and is cached permanently.** Renaming a file changes its display name only, not its URL. There is no way to replace a file in place, so to change an image you upload the new version and repoint whatever uses it. This is deliberate: it means an email that went out last month keeps showing the image it was sent with.

## Who can do what

| Action                          | Who                            |
| ------------------------------- | ------------------------------ |
| View the library and trash      | Every member of the workspace  |
| Upload, rename, delete, restore | Owner, admin, editor, designer |

Viewers can browse and copy links but cannot change anything.

## Limits worth knowing

<AccordionGroup>
  <Accordion title="There is no search on the Media tab">
    The grid shows 24 files per page with paging, in newest first order. Search
    exists inside the image picker, not on the library page itself.
  </Accordion>

  <Accordion title="There are no folders or tags">
    Files are organised only by kind, Images or Videos. Naming files clearly on
    upload is the practical way to find them later.
  </Accordion>

  <Accordion title="You cannot select several files at once">
    Rename and delete act on one file at a time. There is no bulk delete.
  </Accordion>

  <Accordion title="The Primary badge cannot be set">
    Some cards show a **Primary** badge. There is no control in the product to
    set or clear it, so treat it as read only for now.
  </Accordion>

  <Accordion title="Videos are stored but not previewed">
    Video cards show a file icon rather than a thumbnail. Use **Open in new tab**
    to play one.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Templates" icon="file-lines" href="/en/messaging/templates">
    The email builder, where most images end up.
  </Card>

  <Card title="Popup blocks" icon="table-cells" href="/en/messaging/popup-blocks">
    Images, backgrounds and teasers on your storefront popups.
  </Card>

  <Card title="AI provider" icon="sparkles" href="/en/integrations/ai-provider">
    Connect the key that powers AI image generation.
  </Card>

  <Card title="Popups" icon="window-maximize" href="/en/messaging/popups">
    Build and publish an on-site signup popup.
  </Card>
</CardGroup>