# Build an email in the visual editor

> Create a blank email under Marketing Channels › Emails, build it from structures and blocks in the visual editor, personalise it with merge tags and a product block, and save it.

The visual editor builds an email by dragging **structures** (rows with columns) and **blocks** (text, images, buttons, products) onto the page. This guide starts from a blank email, adds a text block with a merge tag and a product block, and saves the email. Saving sends nothing: a campaign or a workflow sends the email. For how emails are sent and counted, read [How emails work](https://releva.ai/documentation/learn/emails/how-emails-work/).

## Before you start

* For a product block, you have a product feed with the **Marketing Channels** scope and a layout with the **Email** scope. See [How product feeds work](https://releva.ai/documentation/learn/product-feeds/how-product-feeds-work/) and [Create a layout for email product blocks](https://releva.ai/documentation/guides/layouts/create-a-layout-for-email-product-blocks/).
* Your plan includes emails. If **New email** shows a lock, ask your account owner.

## Steps

1. Go to **Marketing Channels › Emails**.

   ![Step 1: the Emails list](https://releva.ai/documentation/_astro/step-1.BFmEOSXB_27LVJs.webp)

2. Select **New email**.

   ![Step 2: New email highlighted](https://releva.ai/documentation/_astro/step-2.BVPu-F21_dUnSa.webp)

3. Select **Create Blank** to start from an empty design.

   **Browse Email Templates Gallery** starts from a ready-made template instead.

   ![Step 3: the New email menu](https://releva.ai/documentation/_astro/step-3.CkLwliyj_Z1xdlpi.webp)

4. Enter a **Name** you will recognise in the list, a **Subject** and a **Preview Text**.

   A new email starts with the name “New email” and the date, and the subject “Test email”. **Sender Name** starts with your shop’s default sender name. **Preview Text** shows in the inbox after the subject, not in the email body.

   ![Step 4: Name, Subject and Preview Text filled](https://releva.ai/documentation/_astro/step-4.D_5RcSkI_17y3oo.webp)

5. Open **Structures** to see the row layouts. Drag a structure onto the email to add a row with one or more columns.

   A blank email already has a few empty structures, each with **Drop content here** areas.

   ![Step 5: Structures and Blocks in the editor panel](https://releva.ai/documentation/_astro/step-5.DNC4dMKh_1Azmlo.webp)

6. Under **Blocks**, drag **Text** onto a **Drop content here** area.

   The other blocks are **Image**, **Button**, **Spacer**, **Video**, **Social**, **Banner**, **Timer**, **Menu**, **HTML**, **Product Block** and **Generation Area**. Select a block to change its settings on the right; select **back** to return to the block list.

   ![Step 6: a Text block in the first structure](https://releva.ai/documentation/_astro/step-6.CxcG1Qgs_1kQUyB.webp)

7. Select the text block and open **Merge tags** in the text toolbar. Pick a tag, for example **First Name**.

   The **Releva** list holds profile fields such as **First Name**, **Last Name**, **Email** and **Phone Number**, your custom fields, dynamic coupons and survey values. To give each recipient their own coupon code, pick your list’s **Dynamic coupon: …** entry. Each tag is filled in for every recipient when the email is sent. For links, the link settings offer special links such as **Unsubscribe link**, **Subscribe link**, **Subscription Management Link**, **View in browser link** and one survey link per survey.

   ![Step 7: the Merge tags list](https://releva.ai/documentation/_astro/step-7.BrhAj8nF_Z2mHpDq.webp)

8. Drag **Product Block** onto another drop area.

   The block is a placeholder. Releva fills it with products for each recipient when the email is sent.

   ![Step 8: a product block in the email](https://releva.ai/documentation/_astro/step-8.Dd6rCu9U_1hIc0z.webp)

9. Select the product block. Its settings open on the right.

   ![Step 9: the product block settings](https://releva.ai/documentation/_astro/step-9.DClkd13B_Z1cjyyi.webp)

10. Choose a **Product feed** and a **Layout**, and set **Total products to show**.

    **Product feed** lists feeds with the Marketing Channels scope; **Layout** lists layouts with the Email scope. **Total products to show** is 4 by default, from 1 to 24. The editor keeps showing sample cards; the real products are filled in when the email is sent.

    ![Step 10: product feed and layout chosen](https://releva.ai/documentation/_astro/step-10.BOY2jLO8_Z1XDbWX.webp)

11. Select **Next**.

    ![Step 11: Next highlighted](https://releva.ai/documentation/_astro/step-11.D9Bwb5SC_Zy710.webp)

12. On **Advanced settings**, leave **Sender Email** and **Reply-to Email** empty to use your shop’s defaults, and choose what happens when a profile has already received the maximum number of emails for the day.

    **If max emails per day is reached** offers **Reschedule** (the default), **Send anyway** and **Skip sending**. With **Reschedule**, **Max Reschedules** sets how many times Releva tries again.

    ![Step 12: the Advanced settings tab](https://releva.ai/documentation/_astro/step-12.DS2Rlnkx_Z2vfTyV.webp)

13. Select **Save**.

    ![Step 13: Save highlighted](https://releva.ai/documentation/_astro/step-13.B7mCXYxa_Z2gHTe6.webp)

14. The email is saved. Select **Back To Listing**, **Continue Editing**, or **Send it** to use the email in a campaign or a workflow.

    ![Step 14: Your email was saved successfully](https://releva.ai/documentation/_astro/step-14.C4H9da-B_Z1iFVMd.webp)

## Check it worked

* The email is on the **Emails** list with the badge **VISUAL - STRIPO**.
* Open it: the editor shows the text block and the product block you added.
* Select **Test Email** to send yourself a copy. It is available once your sender domain is verified.

## Troubleshooting

**Email name must be unique!** Another email in this shop has the same name. Change **Name**.

**Save is disabled.** **Name** or **Subject** is empty, the editor is still loading, **Sender Email** on **Advanced settings** is not valid, or a merge tag in the subject, preview text or sender name is broken.

**Invalid Product Blocks Detected.** A product block has no product feed or layout, or one that no longer exists. Select the block and choose both again.

**The feed or layout I want is not in the list.** **Product feed** shows only feeds with the Marketing Channels scope, and **Layout** only layouts with the Email scope.

**The editor shows the HTML code instead of blocks.** The email’s HTML was not built in the visual editor, so drag and drop is off. Start a new email with **Create Blank** or from the template gallery.

## Next steps

* [Create a layout for email product blocks](https://releva.ai/documentation/guides/layouts/create-a-layout-for-email-product-blocks/): Design how each product looks in the product block.
* [Create a one-off email campaign](https://releva.ai/documentation/guides/campaigns/create-a-one-off-email-campaign/): Send the email to a segment once.
* [Create a triggered workflow](https://releva.ai/documentation/guides/workflows/create-a-triggered-workflow/): Send the email automatically when a customer does something.
* [How emails work](https://releva.ai/documentation/learn/emails/how-emails-work/): Learn about sender verification, the daily limit and what is removed when you save.