Qualtrics format guide

QSF File Format Guide

The QSF file format is a JSON-based Qualtrics import and export format. It packages the survey definition so Qualtrics can rebuild questions, choices, blocks, flow, and survey settings.

Convert to QSF Inspect QSF structure

How the QSF format works

QSF is used when a survey is exported from Qualtrics or imported back into Qualtrics. The file acts as a transfer package, not as a general document format for reading or printing.

A QSF export usually contains enough structure for Qualtrics to recreate a survey draft, but advanced platform features can add fields that vary by account, product version, and survey configuration.

Common fields inside QSF JSON

A typical QSF file can include survey metadata, question IDs, question text, choice definitions, blocks, survey flow, embedded data references, display logic, validation rules, and scoring or quota settings.

The exact fields can change with Qualtrics features, so do not assume every valid QSF file has the same shape.

Validation risks before import

JSON syntax alone does not prove that a QSF file is safe to launch. A file can parse correctly while still missing answer choices, survey flow, recode values, or logic needed for the live questionnaire.

The safest workflow is to inspect the file, import it into a blank Qualtrics project, review every question and branch, then compare the imported survey against the source questionnaire.

QSF format facts

Extension: .qsf

Encoding: JSON-based survey structure

Used for: Qualtrics import, export, backup, migration, and survey drafting

Best check: inspect, import into a test project, then review.

QSF File Format FAQ

What format is a QSF file?

A QSF file is a JSON-based Qualtrics survey transfer file. It stores survey metadata, questions, choices, blocks, flow, and Qualtrics-specific settings.

Can I open a QSF file in a text editor?

Yes. Because QSF is JSON-based, you can inspect it in a text editor. Editing it manually is risky unless you understand the Qualtrics fields and validate the result before import.

Does Qualtrics publish a complete QSF schema?

Qualtrics does not provide a stable public schema for every QSF field. Treat QSF as a platform import/export format and test generated or edited files in a non-critical project.

How do I validate a QSF file?

Inspect the file structure, check required survey content, import it into a blank Qualtrics project, and compare the imported survey against the source questionnaire before launch.