Developer Preview
APIs in Developer Preview are subject to change and are not intended for use in production.
Send us your suggestions for improving this API. Your feedback is valuable to us.


Wix Media events are triggered on your site's backend when certain events occur in your media manager. You can write event handlers that react to these events. Event handler functions receive data that corresponds to the event that was fired. Use event handlers to create custom responses to media events.

To add a Wix Media event handler, add an events.js file to the Backend section of your site if one does not already exists. All event handler functions for your site are defined in this file.


  • This module is universal. Functions in this module can run on both the backend and frontend, unless specified otherwise.
  • Backend events don't work when previewing your site.

Event handler functions are defined using the following pattern:


For example, an event handler that handles the update of a file descriptor looks like:

Was this helpful?