Documentation

After Effects rendering in PEXI

Introduction

Pexi renders your After Effects project to MP4 on a dedicated render machine. You upload a collected project, pick a composition and press Render all. You never have to open After Effects to render.

Connect a feed and Pexi renders one video per feed row. Each row fills text, images, video and audio layers in your template. One template can produce hundreds of personalised videos, for example one per product, store or offer.

How it works

You do the first four steps. Pexi does the rest: it sends one job per feed row to a render machine running After Effects, which fills your dynamic layers and renders an MP4.

The template is the only thing you maintain. To change the content, update the feed and render again.

Step 1: Prepare your After Effects project

Set up the final look in After Effects, because Pexi renders the composition exactly as you built it.

  1. Build one render composition. Its size, frame rate and duration become the size, frame rate and duration of the output. Pexi does not resize or trim anything. Give the composition a clear name, such as Main 1080x1920. You select it by name later.
  2. Use one .aep file per project. If the zip holds more than one .aep, you cannot choose which one Pexi uses.
  3. Avoid # in the .aep filename. The render machine removes it, so keep the filename to letters, numbers, spaces, hyphens and underscores.
  4. Convert PSD and AI layers to PNG. For security, Pexi deletes some file types on upload, including .psd, .sketch and .xd. Any layer that uses one of these files renders as missing footage.
  5. Add your font files. Put the .ttf or .otf files you use in the project folder. The render machine installs every font it finds in the package before it renders. Missing fonts fall back to a default font.
  6. Use standard effects and plugins. The render machine runs a standard After Effects install. Third-party plugins may not be installed there. Check with the Pexi team before you use one.
  7. Run File > Dependencies > Collect Files. Choose For All Items. After Effects creates a folder with your .aep, a Report.txt and a (Footage) folder. Pexi uses all three:
    • The (Footage) folder is the only footage folder sent to the render machine. Footage stored anywhere else is not sent.
    • Report.txt lists the compositions. Pexi reads it to fill the composition dropdown.
  8. Zip the collected folder itself. Do not zip only its contents. The zip must contain one folder with the .aep, the report and (Footage) inside it. If you put files at the zip root next to a folder, Pexi ignores the root files. Your .aep may then go missing.

The upload limit is 300 MB per file.

Step 2: Make layers dynamic

To make a layer dynamic, give it the same name as a feed column. Pexi needs no prefixes, tags or scripts. When it renders a feed row, Pexi finds each layer named after a column and fills it with that row's value.

Example feed row

FEED_IDTITLEPRICEPRODUCT_IMAGE
42Summer sale19,99http://example.com/shoe.png

In this example, the composition needs a text layer named title, a text layer named price, a footage layer named product_image and an audio layer named voiceover.

How Pexi uses each value

Feed valueWhat Pexi doesLayer type in AE
Plain textReplaces the Source Text, keeping font, size, colour and animationText layer
A link ending in .jpg, .jpeg, .png, .gif, .webp or .svgReplaces the layer's footage with the imageImage or placeholder footage layer
A link ending in .mp4, .mov, .avi, .webm or .mkvReplaces the layer's footage with the videoVideo footage layer
A link ending in .mp3, .wav, .aac, .ogg or .m4aReplaces the layer's audioAudio layer
EmptyLeaves the layer as designed in AE

Tips for dynamic layers

  • Match names exactly. Layer names are case-sensitive and must match the column name exactly: Title will not match title.
  • Leave room for long text. Feed values vary in length, so use paragraph (box) text or a size-to-fit expression. Line breaks in the feed become line breaks in the text layer.
  • Match the aspect ratio of replacement images. A replaced image keeps the position, scale and effects of the original layer. A different aspect ratio looks stretched or cropped. Use a placeholder image with the same pixel size as the feed images.
  • Make sure replacement video is long enough. Replaced video starts at the layer's in-point. It should be at least as long as the layer.
  • Use an ID column. Each feed row needs a unique ID, so that every video gets its own file. By default Pexi uses the feed_id or id column. You can choose another column under Feed key. The ID column is never sent to a layer.
  • Text, images, video and audio can be dynamic. Colours, positions and other effect properties cannot be set from the feed. To vary a colour, use separate layers or precomps, or drive it with an expression that reads a dynamic text layer.

To make sure the template is complete, check that every dynamic layer in your composition has a matching feed column. Other columns in the feed are ignored, because no layer has their name.

Step 3: Upload the zip to Pexi

You upload an After Effects project the same way as any other creative.

  1. In Pexi, click New > Upload a creative.
  2. Drag your zip onto the page, or click Choose your files or drop them here!.
  3. Set Type and Size for the file. Choose the size of your render composition, for example 1080x1920.
  4. Click Upload creatives.

Pexi unpacks the zip and looks for an .aep file. If it finds one, an After Effects render card appears on the creative's page. If the card is missing, Pexi found no .aep. Check how the zip is structured (see Step 1, point 8).

If you see 413 Error: File is too big., the zip is over 300 MB.

Step 4: Configure and render

You configure the render on the After Effects render card on the creative's page.

  1. Composition. Pick your render composition from the list. Pexi reads the list from Report.txt, or else from the .aep itself. If the list stays empty, type the name exactly as it appears in AE, for example Main Comp 1080x1080.
  2. Feed (optional). Pick the feed that holds the dynamic content. Without a feed, Pexi renders the composition once, exactly as designed.
  3. Feed key (optional). Enter the column that uniquely identifies each row, for example feed_id. If you leave it empty, Pexi uses feed_id or id.
  4. Feed query params (optional). These are added to the feed URL. Use them to render a subset of rows, for example ?filter_by=active.
  5. Click Save settings.
  6. Click Render all.

Pexi sends one render job per feed row to the render machine. While it renders, the card shows a progress ring and a counter such as “12 of 40 rendered”. You can leave the page; rendering continues.

  • Output format: MP4 (H.264, about 15 Mbps). Size, frame rate and duration come from the composition. Pexi does not output GIF, WebM or image sequences.
  • Render time: Jobs render one after another on the render machine, so a large feed takes time. Estimate it as the time one render takes on your own machine, multiplied by the number of rows.
  • Stopping a render: Click Cancel render. Videos that are already finished are kept.
  • Rendering again: Click New render or Render all. Every row renders again. If a row's data is unchanged, its new video replaces the old one. If the data changed, Pexi adds a new video and keeps the old one. Delete old videos you no longer need in the Renders tab.

Step 5: Review, download and use the videos

When the render is finished, the card shows Render complete and a message such as “Render finished: all 40 video(s) done.”

The videos appear in the Renders tab of the card:

  • Click a thumbnail to play the MP4 in a new tab.
  • Click Download to save a video, or Delete to remove it.
  • Use the search box to find a render by name or composition. The tab shows 12 renders per page.

Watch a few renders before you use them, and include the longest and shortest feed values. Pexi has no preview before rendering, so a test render is the quickest way to check text fitting and image cropping. To render only a few test rows, set Feed query params to a filter that returns those rows.

Using the videos in Meta campaigns. A Pexi campaign connected to Meta with the Video type can render and upload the videos automatically, one per feed item. For this to work:

  • The creative size must be 1080x1080, 1080x1350 or 1080x1920.
  • Give the creatives for each size the same base name, such as Summer sale 1080x1080 and Summer sale 1080x1920. Pexi then treats them as one ad in several sizes.
  • A composition must be selected on each creative.

Pexi takes the thumbnail for each Meta video from a frame near the start of the video. Make sure the first half second already looks good.