Configuration

Extension Configuration

The extension can be configured via the TYPO3 Extension Configuration (Admin Tools > Settings > Extension Configuration > contexts).

enableContexts

type: boolean
Default: true

Enable or disable context processing globally.

contextMatchMode

type: string
Default: all

How multiple contexts are evaluated:

all: All assigned contexts must match (AND logic)
any: At least one context must match (OR logic)

Site Set Settings (TYPO3 v13+)

When using Site Sets, configure contexts in your site's settings:

settings:
  contexts:
    debug: false
    matchMode: 'all'

contexts.debug

type: boolean
Default: false

Enable debug output for context matching (development only).

contexts.matchMode

type: string
Default: all

Context match logic: all (AND) or any (OR).

TypoScript Configuration

Basic TypoScript settings for the contexts extension:

plugin.tx_contexts {
    settings {
        # Enable debug mode
        debug = 0

        # Default match mode
        matchMode = all
    }
}

Page TSconfig

Control context field visibility in the backend:

# Hide context fields from certain user groups
TCEFORM.pages.tx_contexts_visibility.disabled = 1
TCEFORM.tt_content.tx_contexts_visibility.disabled = 1

User TSconfig

Per-user context field configuration:

# Allow specific contexts only
options.contexts.allowedTypes = ip,domain,getparam

Caching Considerations

Context-dependent content affects caching. The extension automatically:

Adds context identifiers to cache tags
Varies cache entries by active contexts
Clears affected caches when context definitions change

For optimal performance:

Use a reverse proxy (Varnish) with context-aware VCL
Consider context values in your caching strategy
Use appropriate cache lifetimes for dynamic contexts