new configuration options & event handlers