Upload File

Upload File is the fastest way to turn a ready-made HTML email into sendable content in Dengage. If your design team, agency, or another platform has already produced the HTML, you don't need to rebuild anything. Package the HTML and its images as a ZIP file, upload it, and Dengage generates the email content in seconds.

Use Upload File when:

• You receive finished HTML emails from a design agency or your designers.
• Your team codes emails in its own tools and only needs Dengage for sending, personalization, and reporting.

If you prefer to build the email inside Dengage instead, see the Rich Text Editor, Email Builder, or Code Editor guides.

Before You Start: Prepare Your ZIP File

The upload accepts a single .ZIP file of up to 10 MB. What matters most is the folder structure inside the ZIP. An incorrect structure is the most common reason an upload fails, so it is worth getting right the first time.

Single-Language Structure

The ZIP must contain one folder named exactly after the ZIP file. Inside that folder, place one HTML file and, if your design uses images, an optional images subfolder containing the image files (.png and .jpeg only):

newsletter.zip
└── newsletter/
    ├── newsletter.html
    └── images/          (optional)
        ├── banner.png
        └── product.jpeg

Multi-Language Structure

To create one email with several language versions in a single upload, add one subfolder per language inside the top-level folder. Each language folder must be named with a supported language code written in uppercase (e.g. EN, TR, DE) and must contain its own HTML file and optional images subfolder:

campaign.zip
└── campaign/
    ├── EN/
    │   ├── campaign.html
    │   └── images/
    ├── TR/
    │   ├── campaign.html
    │   └── images/
    └── DE/
        ├── campaign.html
        └── images/

Naming Rules and Limits

Create an Email with Upload File

1. Go to Content > Marketing > Email and click + New in the upper-right corner.
2. In the Select a Type dialog, choose Upload File. (You can also preview an example ZIP from the See sample file link on the card.)

Step 1: General

1. Enter a Content Name. This is the internal name you will search for later; it is not shown to recipients.
2. Pick a Folder to keep your content organized. The default is Email Content; click Change Folder to select another folder or create a new one.
3. Click Next to open the Content step. You can return and rename or re-folder the content at any time with the edit (pencil) icon on the General card.

Step 2: Content Settings (Sender and Subject)

These fields define what recipients see in their inbox before they open the email:

Step 3: Upload the ZIP

1. Review the Folder and File Structure Requirements callout on the screen. It summarizes the rules above and hosts the two sample downloads.
2. Drag & drop your ZIP onto the upload area, or click Select to browse for it. The uploader accepts .ZIP files up to 10 MB.

Once the file is uploaded, you can continue with saving, testing, and publishing from the same screen.

Personalize the Email

Click the <> icon on the Subject, Pre-header, or Reply To field to open the Customization Selector. Pick an attribute and it is inserted as a tag that is replaced with each recipient's own value at send time.

The Customization Selector organizes the available attributes in tabs:

For personalization inside the email body itself, see Advanced Personalization in Email.

Add or Manage Language Versions

Uploading a multi-language ZIP is not the only way to localize. At the top of the Content step, the Add Languages menu offers two options:

• Copy from Content: start a new language version from an existing email content.
• Create Blank Email Content: add an empty language version and fill it in yourself.

The languages of each email content are visible in the Languages column of the email content list.

Save, Test, and Publish

• Save Draft saves your work with the status Draft. Drafts are safe to keep editing and are not available to campaigns yet.
• Test opens the Preview & Test tools: a visual Preview of the email, a Spam Score check (scored 0 to 5) that flags words likely to trigger spam filters, and Send Test to deliver the email to a predefined testing list or to addresses you type in.
• Publish makes the content available for campaigns. Published contents show the Published status in the list, where you can start a campaign directly with Create Campaign.

Quick Reference

Tips for Better Results

• Start from the sample. Downloading the sample ZIP and replacing its HTML and images is the quickest way to a structure that passes validation.
• Use email-safe HTML. Email clients are far stricter than browsers: prefer inline CSS, table-based layouts, and a content width of around 600 px, and always set alt text on images.
• Optimize your images. Compressed .png and .jpeg files keep you comfortably under the 10 MB limit and load faster for recipients.
• Write the pre-header. It's optional, but inboxes will otherwise show the first text they find in your HTML, which is rarely what you want.
• Always run a test. Check the Preview, keep the Spam Score low, and send a test to a real inbox before publishing.

Troubleshooting & FAQ

My ZIP is rejected or the upload fails. What should I check?
In order: (1) the top-level folder has exactly the same name as the ZIP file, (2) there is exactly one HTML file per folder, (3) no quotation marks, apostrophes, underscores, or Turkish characters anywhere in folder or file names, (4) the ZIP is under 10 MB, and (5) in multi-language ZIPs, every language folder uses an uppercase supported language code.

My images don't show in the uploaded email.
Make sure the images are inside the images subfolder and are .png or .jpeg files; other formats are not accepted.

Can I add a language after the first upload?
Yes. Use the Add Languages menu on the Content step and either copy an existing content or create a blank version for the new language.

Where does my uploaded email go?
It is saved in the folder you selected in the General step and appears under Content > Marketing > Email, with the status Draft until you publish it.