How to Build and Distribute Surveys in the Console

Last Updated November 15, 2026

Brief Overview

The Survey Builder lets you create surveys in the WalkMe Console. You can start from a blank canvas, generate a survey with AI based on your goals and audience, import a survey you built in the Editor, or start from a ready-made template.

This article covers the full survey-building process: adding pages and questions, choosing from six question types, and setting up each question. It also covers how to save and publish a survey, distribute it by anonymous link, email, or SCIM, and redistribute it to reach more respondents.

WalkMe Surveys in the Console

Create a Survey

There are four ways to create a survey on the Survey Builder page:

  • Start from Scratch: Build a survey from a blank canvas and customize every question
  • Create with AI: Generate questions tailored to your audience and goals
  • Import from existing WalkMe Survey: Bring in a survey you already created in the Editor
  • Start from a Template: Pick a ready-made survey and edit the questions to fit your needs

Start from scratch

  1. Select + Create Survey
  2. Select Start from Scratch

The survey opens with a welcome message, a question page, and a thank you message. You can edit, add, or remove pages and questions as needed.

Create with AI

  1. Select + Create Survey
  2. Select Create with AI
  3. In the Respondent Audience & Goals step, describe the audience and the survey's subject and goals
  4. Select Next
  5. In the Review step, review the generated survey
  6. Select Use this Survey

You can edit the generated survey before you publish or distribute it.

Import from an existing WalkMe survey

  1. Select + Create Survey
  2. Select Import from existing WalkMe Survey
  3. In the Import Survey popup, select the system that has the survey
  4. Select the survey to import
  5. Select Continue to Settings
  6. Choose the survey structure:
    • Standard: All questions show on one page
    • One Question Per Page: Each question shows on its own page
  7. Select Import

Importing creates a copy of the survey. The original survey in the Editor stays the same.

Start from a template

A template opens a ready-made survey in the builder, with its pages, questions, and logic filled in. Every question stays editable.

  1. Select + Create Survey
  2. Select Start from a Template
  3. In the Start from a template popup, select a template. Each card shows the template name, a short description, the number of questions, and the time to complete.
  4. Select Use this template

To go back to the Create new survey popup, select Back.

The following templates are available:

  • Employee pulse: A quarterly check on workload, clarity, and blockers, with an anonymous free-text question at the end (9 questions, 3 min)
  • Swag or merchandise order: Sizes, delivery preference, and a mailing address that appears only when shipping is chosen (7 questions, 2 min)
  • New hire feedback: A 30-day check-in on onboarding, equipment, clarity, and what helped most (8 questions, 4 min)
  • Event RSVP: Attendance, travel, catering, and workshop choice, with logistics questions skipped for people who can't attend (7 questions, 2 min)
  • Internal tool satisfaction: Which tools people use weekly, where they lose time, and what they'd change (5 questions, 3 min)
  • Customer onboarding feedback: Time to first value, satisfaction, NPS with a reason, and go-live blockers (8 questions, 4 min)

Add and Manage Survey Content

Surveys are built from pages that hold questions or messages. You can add, edit, and reorder content as you build.

Add pages

Pages give your survey structure and control how questions are presented.

  1. Select Add Page
  2. Choose where the page appears in the survey

Question content

When you select a question title or description, a formatting toolbar appears. Use it to add bold, italic, lists, and hyperlinks. You can combine rich text and dynamic text in the same field to create branded, personalized messages.

Dynamic text personalizes content with real user data, like a user's name or environment details. To insert dynamic text:

  1. Select Dynamic Text in the toolbar
  2. Choose a data source:
    • Variable: Type a variable identifier
    • jQuery: Type a jQuery selector to pull data from the page
    • Cookie: Type a cookie name
    • Dynamic Text attributes: Select a pre-configured attribute from the attributes center

Dynamic text appears in a styled box so you can tell it apart from static text. Attributes are read-only in Surveys, so you can't create, edit, or delete them from the Surveys app.

Dynamic Text Attributes

Questions

Question types

  • Multiple/Single Choice: Respondents select one or more answers from a list
  • Message: A general message, separate from any question
  • Free text: Respondents type an open-ended answer
  • Rating: Respondents select from a scale of stars or other icons
  • NPS: Respondents rate how likely they are to recommend a product or service, on a scale of 0 to 10
  • Boolean: Respondents choose between two set options

WalkMe Net Promoter Score (NPS) Surveys

Add a question

  1. Select Add New Question
  2. Select a question type
  3. Add a title and a description (optional)
  4. Add the content for the question type:
    • Multiple/Single Choice: Add the answer options. For multiple choice questions, mark the correct answers. To reorder an option, drag the handle to its left. Select Add Choice to add more options (optional).
    • Message: Add the message content
    • Free text: No extra content needed. A text field is added for the respondent's answer.
    • Rating: Add labels for the minimum and maximum of the scale
    • NPS: Add labels for the low and high scores
    • Boolean: No extra content needed

Question settings

Select a question to open the Question Settings panel. These settings apply to every question type:

  • Select the Question Type dropdown to change the question type at any time
  • Select Upload Image or Video to add media from the Assets Library. For Rating and Boolean questions, turn on Add media instead.
  • Turn on Require response to require an answer before respondents can continue (not available for Message)
  • Select Delete Question to remove the question from the page

The Assets Library opens only after you save the survey and select a system. If you haven't saved yet, a prompt asks you to do that first.

Assets Library

Some question types have more settings:

  • Multiple/Single Choice:
    • Select the Answer Type
    • Select the Format dropdown and choose List to show answers as a visible list, or Dropdown to show them in a dropdown menu
    • Turn on Enable "Select All" option to add a Select All choice, so respondents can select every answer at once

  • Message:
    • Turn on Title in bold to emphasize the message title

  • Free text: No extra settings
  • Rating:
    • Under Format, choose how the rating looks: Stars, Hearts, Thumbs, Emoticons, or Numerical-only
    • Select the Range dropdown to set the number of icons on the scale
    • Set the Inactive color and Active color for the icons
    • Turn on Comment Box to let respondents add written feedback

  • NPS: No extra settings
  • Boolean: No extra settings

Save a Survey

  1. Select Save at the top of the page
  2. Choose the survey type:
    • Popup: Shows the survey in a popup on top of a website. Select the system that hosts the survey.
    • Full Page: Shows the survey as a standalone page in a new browser tab
  3. Select Save

You can't change the survey type or system after you save. Popup surveys can run on web, native mobile, and Mobile Web systems.

Publish Popup Surveys

Popup surveys are published straight to an environment.

  1. Select Publish
  2. Select the environment: Production, Test, or Success
  3. Select Publish

After you publish, the survey appears in the Editor. Set up deployment logic there, like showing the survey after a Smart Walk-Thru or from a launcher. The Surveys app in the console is for creating the survey only.

Note


Previews of Mobile Web surveys open in a fixed, phone-sized window, so they're approximate. Test the survey on a mobile device before you publish.

Publish and Distribute Full-Page Surveys

Full-page surveys are published and distributed from the Production environment only. In Test or Success, Publish & Distribute is turned off and the publish status is hidden. You can still save your changes and switch to Production when you're ready.

Select Publish & Distribute, then choose a distribution method.

An anonymous link is a shareable link that doesn't identify respondents.

  1. Select Distribute by Anonymous Link
  2. Select Publish
  3. Select Copy Link and share it with respondents

Distribute by email

Email distribution sends the survey to a list of contacts.

  1. Select Distribute by Email
  2. Add participants in one of these ways:
    • Select Download Template, add participants' email addresses to it, and then select Upload
    • Select one or more lists under User lists available
  3. Select Next
  4. Fill out the survey invitation email:
    • Email subject: Appears in the recipient's inbox and at the top of the email
    • Title: The heading in the email body
    • Message: The email content
    • CTA button text: The text on the email's button
  5. Set the survey availability:
    • Activate survey now: The survey stays open until you archive it
    • Set specific start and end date: The survey is open for a set time
  6. Select Publish and Distribute

On the user lists step, you can also manage saved lists:

  • Search: Find a list
  • Edit: Rename a list
  • Delete: Remove a list from the distribution manager
  • Expand: View every email address in the list

Each list shows its name and the number of email addresses in it.

Distribute with SCIM

System for Cross-domain Identity Management (SCIM) distribution sends the survey to an audience based on identity attributes from your organization's identity provider. The audience updates on its own, so the list stays current.

If SCIM isn't set up in your Admin Center, Distribute with SCIM is turned off. Contact your admin to check the integration.

SCIM API for WalkMe

  1. Select Distribute with SCIM
  2. Choose your audience:
    • All users: Selects every user from your identity provider
    • Assign by segment: Choose an existing segment, or select Create to build one
    • Assign by users: Search for users by name or email and select them

  3. Review the user count and preview on the right
  4. Select Next
  5. Fill out the invitation email and set the survey availability, the same way as for email distribution

Condition Builder

Redistribute a Published Survey

A published full-page survey is read-only, but you can redistribute it to reach more respondents.

  1. Open the published survey
  2. Select Redistribute
  3. Choose a method:
    • Resend to incomplete participants: Sends the survey again to people who were invited but haven't finished it
    • Send to a new audience: Sends the survey to a different distribution list, or a list you upload

  4. Select Next
  5. Choose the audience:
    • To resend to incomplete participants: Review the lists under Previously sent distribution lists
    • To send to a new audience: Select the distribution lists to send to. To add a list, select Upload and import a CSV. You can select Download Template to get the right format (optional).

  6. Select Next
  7. Fill out the invitation email and set the survey availability, the same way as for email distribution
  8. Select Redistribute

Technical Notes

  • CSV files uploaded for email distribution are checked and saved for future use
  • You can add images or videos to a question only after you save the survey and select a system
  • You can't change the survey type or system after you save
  • In Test or Success, Publish & Distribute is turned off for full-page surveys and the publish status is hidden
  • Previews of Mobile Web surveys use a fixed, phone-sized window, so test on a mobile device before you publish

Was this article helpful?

Thanks for your feedback!

Be part of something bigger.

Engage with peers, ask questions, share ideas

Ask the Community
×
×