Skip to main content
Introduced in: 6.1.0. Action required: only if you opt into restricted survey visibility. Back to the 6.1 checklist.

Survey visibility (opt-in)

Surveys can now be restricted to their owner and the organization’s owners and managers. New columns on the Survey table record each survey’s owner and visibility. The migrations set every existing survey to workspace-visible and make its creator the owner, so access is unchanged after the upgrade.
Once the marker is set, every survey a person creates starts Restricted to its author and the organization’s owners and managers. They can make it visible to the workspace from Collaborate or when activating it. See Survey visibility.
Stored visibility is always enforced. To enable new visibility mutations and survey graph checks, complete the rollout below after upgrading. Once activated, a survey a person creates is restricted until they share it with the workspace. Regardless of readiness, API keys cannot see restricted surveys or responses; webhooks, integrations, feedback sources, follow-ups and workflows cannot receive them. Two new environment variables:
  • SURVEY_VISIBILITY_FORCE_DISABLED: 1 disables visibility mutations. Stored restrictions remain enforced. Takes effect on restart.
  • SURVEY_WORKSPACE_LIMIT: most surveys one workspace may hold, archived ones included (default 10000). This applies whether or not visibility is enforced: creating a survey past it answers 422 workspace_survey_limit_reached. Raise it before upgrading if a workspace is near the default.

Complete the visibility rollout

Open a shell in the upgraded app

The commands below ship inside the Formbricks image; no host installation of formbricks-authzed is needed. Confirm every app container/pod runs the target release, then open one shell:
From your existing Compose directory:
Run the following steps inside that shell, using the app’s existing database and AuthZed settings. Stop on any nonzero exit; do not mark the scope ready after a failed repair. Type exit when finished.

Repair and verify

1

Repair outbox delivery

Once every container or pod runs the new version, check durable delivery and replay any dead-lettered survey events. The migration adds the survey trigger while the previous version may still be delivering outbox events, and that version dead-letters the survey event type it does not know. A dead-lettered survey revocation makes every enforced authorization check fail closed until it is replayed:
replay resets every unresolved dead letter, so investigate any that are not survey events first. See AuthZed operations for how to list them.
2

Repair the survey scope

After the upgrade, repair the survey scope and mark it ready. This runs the repair, then two further dry runs, and sets the marker only if both come back clean:
3

Confirm readiness

Confirm formbricks-authzed upgrade check reports scopes.survey as ready.
To clear survey graph readiness, run formbricks-authzed backfill --scope=survey --clear-ready. Stored restrictions remain enforced. See AuthZed operations for the audit and repair commands.