For the complete documentation index, see llms.txt. This page is also available as Markdown.

Using Metaforms: Step-by-Step

1. Log in to Qualtrics

  • Open Qualtrics in Chrome and log in with your usual account.

2. Log in to Metaforms

  • Click the Metaforms icon to open the extension.

Open the Metaforms extension
  • Sign in with your Metaforms credentials.

Log in with Metaforms credentials

3. Configure your Qualtrics URLs

The first time you log in, Metaforms asks for your Qualtrics URLs. The extension works only on the Qualtrics URLs added here.

  • Copy the URL from the Qualtrics address bar and paste it into Qualtrics URLs, for example https://yourorg.az1.qualtrics.com.

  • If your organization uses more than one Qualtrics instance, click Add another URL and paste each one.

  • Click Save and continue.

Configure your Qualtrics URLs in the Metaforms extension

4. Open the Qualtrics survey

  • In Qualtrics, create a new project, or upload the QSF file for the survey you want to program.

Create a project or upload a QSF file
  • Keep that survey open. The extension detects the Qualtrics page when its URL has been added.

5. Enter the project details

  • After the survey is open, the extension asks for the project name and study type.

  • Select Ad Hoc.

  • Select test mode if this project should run in test mode.

Project name and study type prompt

6. Create the project in Metaforms

  • Enter the same project name you used in Qualtrics.

  • Leave the study type as Ad Hoc, then click Create Project.

Create Project in the Metaforms extension

7. Choose AI rules and upload the questionnaire

  • Choose whether to apply AI rules to this project.

Choose whether to apply AI rules

Use an AI rule when Metaforms should follow the same programming standard on every question. A rule is a standing requirement, not a one-time edit.

Example standard: “For all single-select questions, include a ‘Prefer not to answer’ option unless the client specifically excludes it.”

If you already have standards written down, email the explanation to help@metaforms.ai. The Metaforms team can add the rule for you. If you do not need a rule for this project, continue to the questionnaire upload.

  • If you haven't uploaded a template QSF, Qualtrics starts with one block that contains a single-select question. In the extension, upload the questionnaire Metaforms should program.

  • Supported file types are .doc, .docx, .xls, .xlsx, and .pdf.

Upload the questionnaire

8. Generate the first questions

  • Click Generate Next 5 Questions.

Generate Next 5 Questions
  • Wait while the extension reads the questionnaire and creates the questions.

Questions generating
  • When the batch finishes, Qualtrics reloads. Review the new questions in the Survey builder, then open Survey flow and confirm the new blocks and elements are in the right order before you continue.

Survey reloaded with generated questions
Survey flow after the first batch, with branch logic and End of Survey elements after each screener block
Survey flow after the first batch

9. Edit questions that are already created

  • To update questions that are already in the survey, type the instruction in the prompt box and send it. You do not need a separate edit action.

Example prompt sent in the Metaforms Chat Assistant, with AI is thinking shown
  • Metaforms lists an update for each question and ticks it off as it is applied.

Chat Assistant applying the instruction update to S1 through S8
  • After you see Completed all actions, check the questions in the builder and confirm the instruction formatting changed. In this example, the S1 instruction now reads (Mandatory to answer) on its own line.

S1 in the builder with the instruction (Mandatory to answer) on a new line
S1 after the edit is applied

10. Generate the next batch

  • After your edits are complete, click Generate Next 5 Questions.

Generate next 5 questions sent in the Metaforms Chat Assistant
  • The Chat Assistant lists each action and ticks it off as it finishes. Keep the extension open until you see Completed all actions.

Chat Assistant processing the next batch of actions
  • Review the new questions in the Survey builder: question text, answer choices, question type, and hidden questions.

Builder showing the newly generated S6 question and the RECENT_PURCHASER hidden question
Builder after the next batch
  • Open Survey flow again and confirm the latest blocks, branches, and End of Survey elements are in the right order.

Survey flow showing a branch on S6 that ends the survey, followed by the Screener_5 block
Survey flow after the next batch
  • Repeat the review, edit, and generate cycle until the questionnaire is fully programmed.

For the question types Metaforms can create, see Question types supported.

Last updated

Was this helpful?