Creating landing pages

Learn how to create and customize a landing page using the drag-and-drop editor, so you can grow your audience and collect preferences directly in Braze.

Prerequisites

To access the landing page builder, you need certain permissions. If you don’t have access, ask your Braze admin for help.

Creating a landing page

Step 1: Create a new draft

Go to Messaging > Landing Pages, then select Create landing page. You can also select the name of an existing landing page to duplicate or make changes to it.

Step 2: Enter the page details

Add internal and public-facing details that help you organize, brand, and share your landing page.

General details

Enter a name and description for the landing page. These details are used to search for the page in your internal workspace. They won’t be visible to your customers.

Site details

Set up metatags to customize how your page appears on the browser tab and optimize for search engine results. These will be visible to your customers.

We suggest following these best practices:

Field	Description	Recommendations
Site title	The title that displays on the browser tab.	Use up to 60 characters.
Meta description	A text snippet that displays in search results.	Use between 140-160 characters.
Favicon	The icon that appears next to the site title on the browser tab.	Use an aspect ratio of 1:1, and a supported file type of PNG, JPEG, or ICO.
Page URL	This is URL path to your landing page. This value is also referenced when using landing page liquid tags that you can embed in a message to automatically identify when they submit your form.	This value must be unique across your workspace.

Step 3: Customize the page

If you haven’t already, select Save as draft. To start customizing your page, select Edit landing page. The drag-and-drop editor will preload with a default template that you can customize to fit your use case.

The editor uses two types of components for landing page composition: basic blocks and form blocks. All blocks must be placed in a row.

Basic blocks

You can use these blocks to add content and customize the layout of your landing page.

Block Type	Description
Title	A text block for adding a heading or title to your content. Useful for structuring sections and improving readability.
Paragraph	A text block for longer descriptions or additional context. Supports rich text formatting.
Button	A clickable element that directs users to a specified action, such as opening a link or submitting a form.
Image	A block for displaying images. You can upload an image or provide a URL to reference an external source.
Link	A hyperlink that users can click to navigate to a specified URL. Can be embedded within text or standalone.
Spacer	An invisible block that adds vertical spacing between elements for improved layout and readability.
Custom Code	A block that allows you to insert and run custom HTML, CSS, or JavaScript for advanced customization.

Form blocks

You can use these blocks to create a form that links user-submitted data to their profile in Braze. Keep in mind, if you use form blocks, you’ll also need to create an additional landing page for the confirmation state.

Block Type	Description
Email Capture	A form field for email addresses. When submitted, the email address is added to that user’s profile in Braze.
Phone Capture	A form field for phone numbers. When submitted, the user is subscribed to your SMS or WhatsApp subscription group.
Input Field	A form field that supports standard attributes (such as first and last name) or a custom attribute string of your choice.
Dropdown	Users can select an item from a pre-defined list. You can add any custom attribute strings to the list.
Checkbox	If a user checks the box, the block’s attribute is set to true. If left unchecked, it’s attribute is set to false.

Page container styles

You can set styles to be applied across all relevant component blocks in your landing page from the Page container tab. These styles will be used everywhere on your page except where you override them with a specific block.

We recommend setting up page container-level styles before you customize styles at the block level. You can also add a background image for the entire page.

Optional and required fields

You can choose whether a form field is required or optional. Required fields must be filled out before the form can be submitted. Optional fields can be left blank or unselected by a user.

For example, to enforce consent capture before form submission, you can turn on Required field input to set a checkbox to be required with the appropriate disclaimer text.

Step 4: Create a confirmation page (optional)

If your landing page doesn’t include a form, continue to the next step.

If your landing page includes a form, create a second landing page to serve as the confirmation experience. This page should thank users or provide a next step after form submission.

To link the confirmation page:

• Select the Submit button on your form
• Use the Open web URL action to link to your confirmation page

If you don’t include a confirmation page, users may not know their form was submitted successfully. Always include a confirmation experience to complete the journey.

Step 5: Preview the page

You can preview your landing page in the editor’s Preview tab. After saving your landing page as a draft, you can visit the URL by going to Landing Pages and selecting Copy URL next to your landing page. You can also share the URL with collaborators.

Before you publish, make sure:

• You haven’t exceeded your plan’s published landing page limit
• Each form-based page links to a confirmation page using the Open web URL action
• All required page fields (like URL path and title) are complete

When you’re ready, select Publish Landing Page.

Using templates

Use landing page templates to create templates for your next campaigns. These templates can be accessed and managed in both the landing page editor and the Templates section of the dashboard (Templates > Landing Page Templates). Landing page templates require a name and optionally require a description.

Managing templates

You can preview, archive, edit, or duplicate landing page templates. When editing a landing page, you can also save your landing page as a template, make changes to the template, or delete the content of the landing page.

Viewing analytics

To analyze the effectiveness of your landing page, go to Messaging > Landing Pages, then selected a landing page you’ve published. Here, you can track the number of page views, page clicks, page submissions, and the submission rates for your landing page.

Handling form submission errors

If a user tries to submit a form with missing or unsupported input, they’ll see a generic error message and won’t be able to submit.

Common causes:

• Required fields are left blank
• Special characters are used in text inputs
• A required checkbox is not selected

Error messages shown to users can’t be customized. Preview your landing page to confirm field behavior before publishing.