Create a Cloud Page

Use this guide to create and publish a Cloud Page. A Cloud Page is a public web page you build in Pushwoosh for promo campaigns, lead forms, quizzes, and other click-through landing pages.

Before you start

• Cloud Pages is available on request. Contact Pushwoosh Support to enable it for your project.
• Decide where to redirect users after the main action on the page. The redirect can be any URL you control, for example a thank-you page, a results page, another Cloud Page, or another campaign URL. Prepare that URL before you test submit.

Create a page

1. Go to Content → Cloud Pages.
2. Click Create cloud page. This opens the page editor directly, where name, redirect, and content all live on one screen.

3. Click the page name next to Create page: and enter a name.
4. Add the URL in After submit, redirect to. This field is required. Use it to define where users go after completing an action on the page, for example to a thank-you page or another campaign page.

5. In the dropdown next to it, choose what happens when an existing contact submits the form again:
   • Update existing user (default): updates the contact profile fields with the submitted values.
   • Skip tags for existing user: registers the device the user submits from, but does not update existing tags on the contact profile.
   • Show error for existing user: for one-time signups such as exclusive offers or webinars. If the contact already exists, the submission is rejected, the profile is not updated, and the user is redirected back to the form and sees an error message.

Build page content

Most lead pages need a Form block. Follow Create a lead or submission form after you add the basic layout. If you only need content and a button, you can skip the form section.

1. In the Blocks panel on the right, click or drag blocks onto the canvas.
   • Most blocks are the same as in the email editor. To configure them, see the email editor blocks guide.
   • Group: drop blocks into a Group when you want to move, hide, or style several of them together (shared background and spacing), or arrange them in a row instead of stacked with Direction: Horizontal. Add or remove blocks in the Layers panel by dragging them into or out of the group.
   • Form: see Create a lead or submission form below.
2. Edit the block content on the canvas.
3. Repeat for each block you need.
4. Click Save.

Tip

The AI tab next to Blocks can generate a starting layout from a text prompt or a suggested template (newsletter signup, event registration, product launch) instead of building it block by block.

Create a lead or submission form

Add a form to collect contact details and other values you need for segmentation. A Tag name is the field name saved on the contact. Use a clear name such as email or fitness_goal so you can find that value later in segments and User Explorer.

1. From Blocks, add a Form block.
2. In the Form panel, under Fields, click Add field.

3. In the fields list, click the edit (pencil) icon on the field to open its settings.

4. In the field settings, configure the field:

   • Tag name: the name saved on the contact (for example fitness_goal)
   • Type: the input type (for example Text, Phone, or Dropdown)
   • Label and Placeholder
   • Options (one per line): if Type is Dropdown, enter one choice per line
   • Required: enable if users must fill this field before submit

   To delete the field, click Remove field.

5. Repeat steps 2–4 for each field you need.

6. Under Submit button, set the Label. Optionally adjust Background, Text color, and Corner radius.

7. Click Save.

What happens after form submission

After submit, Pushwoosh creates or updates the contact and sends the user to your redirect URL. The details below help you verify the result in User Explorer and use the submission in Customer Journey. They are not extra setup steps in the editor.

Note

The flow below describes what happens when a new contact submits the form. For existing contacts, the outcome depends on the On existing user page setting.

Contact profile and devices

When a user submits the form, Pushwoosh creates or updates a contact profile in User Explorer.

For example, if the form includes an email field and a phone field, Pushwoosh registers one Email device and one SMS device. Both devices are linked under one User ID.

Tags

All other fields are saved as custom tags by field name. For example, if your form has fitness_goal and workout_frequency fields, the contact profile will show tags like fitness_goal = Boost endurance and workout_frequency = 3–4x a week.

The page code is saved in the PW_CloudPageCode tag.

Event

Pushwoosh fires PW_FormSubmitted on every form submission. You can see it in the Events History tab on the contact profile in User Explorer. The event includes a form_code attribute that identifies which Cloud Page the submission came from, and a timestamp of when it occurred.

Use it as a trigger in Customer Journey to start welcome sequences, follow-up flows, and other automation. For example, you can build a journey that sends a welcome email immediately after a user submits a fitness quiz form, then follows up with a personalized workout plan 24 hours later.

Test the page

After you save the page, it becomes publicly accessible via its URL. The default format is https://cloud-pages.svc-nue.pushwoosh.com/cloud-pages/v1/page/<page-code>.

Note

If you requested custom domain setup through Pushwoosh Support and the setup is complete, it will use your domain URL instead: https://domain.com/{slug}.

1. Use the back control in the editor to return to Content → Cloud Pages.
2. In the page list, open the page action menu and click Preview.
3. Copy the public URL from the browser address bar when the preview opens. Use that URL in a message CTA, Customer Journey, or ad.
4. Verify that the page content loads correctly and is displayed as expected.
5. If your page includes a form, fill in the form with test data and click the submit button. Use a clearly named test email so you can find or remove that contact in User Explorer afterward.

Note

Test submissions create real contact profiles in Pushwoosh.

6. Confirm that the redirect opens the expected page.
7. Open User Explorer and confirm that the submitted user data and tags are displayed.

Edit or delete a page

All Cloud Pages are listed in Content → Cloud Pages, where you can manage and edit them.

1. Go to Content → Cloud Pages.
2. Open the page action menu.
3. Click Edit or Delete the page.