Events usage guide#
An event is the trigger that starts a ShopMagic automation. It tells ShopMagic when to check the automation's filters and run its actions.
Events can respond to activities such as creating an order, changing an order status, registering an account, or submitting a form. Some add-ons also provide scheduled events and manual triggers.
How events work#
For example, New Order responds when a WooCommerce order is created. You can configure the automation to send an email, send an SMS through the Twilio add-on, or perform another available action.
New Order does not confirm payment. If your workflow should start when an order becomes paid, choose Order Paid. For a specific status transition, use Order Status Changed.
If you add filters, the actions run only when those conditions pass. Without filters, there are no additional filtering restrictions, but the event's settings and other execution conditions still apply.
How to select an event#
- Go to ShopMagic → Automations and create or edit an automation.
- Select an event from the Event dropdown.
- Complete any event-specific settings, such as source and destination statuses, a selected form, or the number of days before a scheduled date.
- Configure optional filters and at least one action.
- Save and publish the automation when it is ready.
Each automation has one event, but it can contain multiple filters and actions. If you need separate triggers, create separate automations or choose a broader event and narrow it with its settings.
Events determine available data#
The selected event supplies the data used by filters, actions, and placeholders. An order event can supply an order, while a form submission event supplies form data.
Choose components that match that data. For example, a customer account event does not automatically provide the customer's latest order. Review your filters and placeholders whenever you change an automation's event.
Scheduled and manual events#
Not every event follows an immediate customer action. Integration add-ons can check for upcoming dates, such as a subscription renewal. Manual Actions lets you preview existing records and start an automation yourself.
Actions normally run through a background queue, so execution may not be immediate. Publishing an automation does not replay earlier events or automatically process past orders.
Available events#
Availability depends on the active plugins and ShopMagic add-ons. See the complete list of ShopMagic events for descriptions and requirements.
To verify the trigger, produce a controlled instance of the selected event and check Queue and Outcomes. The Send test feature checks an individual email action; it does not trigger the event or evaluate filters.