Run-when conditions

Run-when conditions let you attach precise execution rules to a snippet — restricting it to specific pages, post types, user roles, or any custom logic you define.

Targeting with conditions#

A snippet's scope is the coarse gate: it separates front-end execution from admin execution. Run-when conditions go further — they are a rule builder that restricts exactly when a snippet executes within that scope.

You can combine multiple conditions in a single rule set. For example, you might target a snippet to run only on singular posts of a specific post type, only for logged-in users with a particular role. This level of targeting keeps snippets lean and avoids loading code where it is not needed.

Authoring is a Pro feature#

Conditions are always enforced#

Once conditions are set on a snippet, they are evaluated on every execution — in every edition, including the free edition. This is an intentional design decision: downgrading from Pro to the free edition never silently removes a snippet's targeting or causes it to run where it should not.

You lose the ability to author new conditions without Pro, but existing conditions on any snippet remain fully active and enforced.

Related#

For the coarse environment gate, see scopes. To unlock condition authoring and all other Pro features, see SnipCraft Pro.