Scripting - Subscribe to Filter Widget state changes
We’re excited to roll out a new Scripting capability:
Subscribe to Filter Widget state changes
. Previously, Script widgets had no way to access or stay in sync with the state of other dashboard widgets. This update removes that limitation, allowing script widgets running in sandboxed iframes to automatically receive filter state and respond to changes in real time. The result is dashboards that behave more like interactive applications rather than static reports.
Key Highlights
  • Real-Time State Awareness: Script widgets can now receive events when a subscribed Filter widget changes. Previously, filter values were not accessible to scripts.
  • Initial State Access on Load: Each Script widget now receives the current filter state when it initializes, ensuring it starts with the correct context.
  • Targeted Subscriptions: Subscribe to specific Filter widgets so only relevant filter changes trigger your scripts.
  • Enhanced Dashboard Interaction: Build responsive, interconnected dashboards where widgets react dynamically to shared state.
  • Built for the Future: The underlying design supports future expansion to additional dashboard events, such as grid selection or record focus changes.
How It Works
  • Script widgets subscribe to one or more Filter widgets using a secure subscription API that delivers both the current filter state and subsequent updates directly to the script.
  • When a Filter widget changes, the subscribed script receives an event with the latest selection data and can respond automatically.
  • The subscription model ensures scripts stay synchronized with filter state throughout the dashboard session.
  • Multiple Script widgets can subscribe independently, with subscriptions scoped to the active dashboard session to prevent cross-interference.
This update removes a long-standing limitation around cross-widget awareness and enables true event-driven scripting on dashboards—unlocking more dynamic, context-aware SmartSuite experiences.