Skip to main content
Screener questions can now be edited after publishing
Screener questions can now be edited any time after a project is published. It is important to note there are some catches.
  • When updated screener questions after publishing, the screener is effectively replaced
    • This means that if answers have already been collected, they are still qualified on the original screener
    • Only new screener responses will be qualified based on screener updates
We generally recommend using this only as a fallback if there was an error in screener setup or if no screener responses have been submitted. If you choose to accept edits after responses have been collected, you can use the createdAt field in the screener response to cross reference with the screener update time to manage different qualifications.

​
Question types and logic

The screener questionType can be selected from a set list of strings. Radio and checkbox answers can have additional answer logic and skip logic applied.
All projects require at least 2 screener questions
questionTypeUse caseanswerValue SchemaSkip logic
radioSingle select1 = Qualify 2 = DisqualifyYes
checkboxMulti select1 = May Select 2 = Must Select 3 = DisqualifyYes
singleLineTextboxShort form text boxn/aNo
multiLineTextboxLong form text boxn/aNo
numericBoxSingle entry numbern/aNo
sliderScaleNumber selectorn/aN

​
Basic screener question setup

POST: /v1/projects/:projectId/screener-questions The examples below show a basic setup for each question type.
  • For all examples isRequired is set to true and skipLogic is set to false
  • All question types can be required or not
  • Only radio and checkbox questions can include skip logic
    • These question types can also include an other option, but do not require it
    • The radio example shows the inclusion of an other option while checkbox example shows no other option
  • Each example shows the minimum fields required, but other fields may be available. 
{
  "questionType": "radio",
  "text": "What is your favorite coastline in the United States?",
  "answers": [
    {
      "text": "East Coast",
      "answerValue": 2
    },
    {
      "text": "West Coast",
      "answerValue": 1
    },
    {
      "isOther": true,
      "text": "Other",
      "answerValue": 2
    }
  ],
  "skipLogic": false,
  "includeOtherOption": true,
  "isRequired": true
}