How to publish a DIY survey (engagement questionnaire)

Tomer Arad
Tomer Arad
  • Updated

Path: Ask › Surveys › DIY surveys

This guide shows you how to publish a DIY survey so residents can start responding. Publishing makes the survey live according to its open date, close date and visibility settings.

Terms used in this article: In the platform, a DIY survey may also be called an engagement or live engagement . All of these refer to the same thing.

Before you start

You can publish only when:

  • You have editor permissions to the survey or if you are a Client Admin.
  • The survey has an Opens date and time and a Closes date and time, set in the Settings tab. This is required.

Recommended: Click View draft to check the survey as residents will see it. Most settings lock after publishing.

Time zone: Open and close times use your local time zone.

Steps to publish

  1. Go to Ask > Surveys > Filter by Survey Type and open your DIY survey.
  2. In the Build tab, check that all questions are final.
  3.  In the Settings tab:
    1. Set the Opens and Closes dates and times, then click Save.
    2. Set Publicly Visible to ON. This will make the survey visible on the pages where it is advertised.
    3. Under Advertise On select the pages you would like the survey to be visible on  
    4. Click Save
  4. From any tab, click Publish in the top right. This will make the survey live. 
  5. Click Take Offline to cancel and go back to editing.

How to check it worked

  • A green notification appears: “Activity Published Successfully”.
  • The Publish button is replaced by View Published and Take Offline.
  • The status changes from Unpublished to:
    • Upcoming if the open date is in the future.
    • Open if the current time is between the open and close dates.
  • When the close date passes, the status changes to Closed and the survey stops accepting responses.

Who can see the survey

Publicly Visible What residents see
ON The survey appears on any page it is advertised on and anyone visiting can find it.
OFF The survey can be reached only through its direct link.

To get the direct link:

  1. Go to Share tab
  2. Click Copy Web Link to share the survey's web page 

Other sharing methods —QR code and direct email invite— are available too depending on your use case

Kiosk Mode add further access controls on top of visibility. See: Requiring participants to log in to a survey

After publishing

Action What it does
View Published Opens the live survey as residents see it.
Take Offline

Stops resident access. Responses already collected are kept. Residents opening the link see "This activity is now closed and responses are no longer being collected. Any response data you have submitted on previous pages has been collected." 
 

You can republish.

Archive (main surveys page > ⋮ menu) Permanently disables the survey.

Editing a published survey

Most settings can be changed while the survey is live. 

  1. If you're editing a published survey a banner will appear at the top saying 'Unpublished Changes - There are unpublished changes. Republish to make them live.' 
  2. To view the changes without publishing the survey click View Changes
  3. To view the live survey click View Published

In-Depth Guide

Pre-Publishing Requirements

Before you can publish, ensure:

  • Questionnaire content is complete in the Build tab
  • Open and close dates are set in the Settings tab (required)
  • All other settings are configured as desired
  • Any translation work is completed (if applicable)

The system validates these requirements and prevents publishing if critical information is missing.

Troubleshooting

If publishing fails due to validation issues:

The system displays clear error messages to guide you:

  • Settings tab: Error banner states "1 Error Found: Set Dates & Times Before Publishing"
  • Build tab: Error banner shows "1 Error Found: Set Dates & Times Before Publishing"
  • Date fields: Show "Error message" text under empty date/time fields
  • Bottom notification: Red banner states "Publishing Failed. Fix errors and try again."

To resolve validation errors:

  1. Navigate to the Settings tab
  2. Set both Opens and Closes dates and times
  3. Click Save to apply the changes
  4. Return to any tab and click Publish again

If publishing fails due to system issues:

  • You'll see a red notification: "Publishing Failed. Try again"
  • Your work is automatically saved, so no content is lost
  • Simply attempt to publish again after the system issue resolves

Post-Publishing Management

Once your questionnaire is published:

  • View: Experience your questionnaire exactly as participants will see it
  • Take Offline: Temporarily disable access while preserving response data
  • Settings: Most settings become locked, but you can still view configurations
  • Archive: Permanently disable the questionnaire (available in Settings tab)

Publishing Timeline and Processing

Understanding the publishing process:

  • Publishing typically completes within a few minutes
  • During processing, the Publish button may show a loading state
  • The system coordinates activation across multiple components
  • Your questionnaire remains accessible for editing until publishing completes
  • Status updates occur automatically once the process finishes

Understanding the Details

Validation Requirements

The publishing system enforces critical requirements to ensure questionnaire functionality. Open and close dates are mandatory because they define when participants can access your engagement. Without these dates, the system cannot properly schedule or manage access.

Visibility and Access Control

Publishing behavior varies based on your Publicly Visible setting:

  • Publicly Visible ON: Questionnaire appears on configured pages and can be discovered by community members browsing your site
  • Publicly Visible OFF: Questionnaire is accessible only via direct links you distribute to specific participants

Additional settings like Requires Code and Kiosk Mode work in combination with visibility settings to provide layered access control.

System Coordination

Publishing involves coordinating multiple system components to ensure consistent questionnaire availability. This includes activating response collection, enabling participant access, applying visibility settings, and initializing analytics tracking.

Important Notes

Publishing Timeline: The publishing process may take a few minutes to complete across all systems. Your questionnaire will become fully accessible once this process finishes.

Settings Lock: Most questionnaire settings cannot be changed after publishing without first taking the questionnaire offline.

Response Collection: Once published and within the active date range, your questionnaire immediately begins accepting and storing participant responses.

Error Recovery: If publishing fails, your work is automatically saved and you can retry once issues are resolved. The system preserves all content and settings during error recovery.

Was this article helpful?

/

Comments

0 comments

Please sign in to leave a comment.