Skip to main content
โ† Back to all release notes
Upcoming

โ›“๏ธโ€๐Ÿ’ฅ Explicit interaction syntax for Canvas Dashboard

enhancement
Explicit interaction syntax for Canvas Dashboard

Canvas dashboard's explicit_interactions list now states every active connection directly, so what's written is what's active, nothing is assumed.

Also, you can name target blocks directly across FilterInteraction, PopInteraction, and DateDrillInteraction without CustomMapping wrapper needed.

Before vs afterโ€‹

Comparing the old and new syntax highlights how the explicit interaction model simplifies your dashboard configuration by making all active connections visible at a glance.

  • โŒ Before (Old Syntax)

    // Old syntax - only the disabled links are visible, not the active connections
    interactions: [
    FilterInteraction {
    from: 'f1'
    to: [
    CustomMapping {
    block: ['v3', 'v4']
    disabled: true
    }
    ]
    }
    ]
  • โœ… After (New Syntax)

    // New syntax - active connections stated directly
    explicit_interactions: [
    FilterInteraction {
    from: 'f1'
    to: ['v1', 'v2'] // Bare block names, no CustomMapping wrapper
    field: r(model.field) // Set once on the entry, not per target
    }
    ]

Migration to new syntaxโ€‹

We don't support mass conversion yet, but the transition is seamless:

  • New dashboards automatically use the explicit_interactions: syntax.
  • Existing dashboards convert when you next update their control or cross-filter setup.
  • Legacy interactions: syntax remains functional, without breaking changes.

Timelineโ€‹

We expect to release this around mid-September 2026.