Event Types

AccountRegistrationEvent

This event is fired when a new user registers an account, either as a stand-alone signup or after placing an order.

Signature

class AccountRegistrationEvent extends VendureEvent {    constructor(ctx: RequestContext, user: User)}

Extends: VendureEvent

AccountVerifiedEvent

@vendure/core Source

This event is fired when a users email address successfully gets verified after the verifyCustomerAccount mutation was executed.

Signature

class AccountVerifiedEvent extends VendureEvent {    constructor(ctx: RequestContext, customer: Customer)}

Extends: VendureEvent

AdministratorEvent

@vendure/core Sourcev1.4

This event is fired whenever a Administrator is added, updated or deleted.

Signature

class AdministratorEvent extends VendureEntityEvent<Administrator, AdministratorInputTypes> {    constructor(ctx: RequestContext, entity: Administrator, type: 'created' | 'updated' | 'deleted', input?: AdministratorInputTypes)}

Extends: VendureEntityEvent<Administrator, AdministratorInputTypes>

ApiKeyEvent

@vendure/core Sourcev3.6.0

This event is fired whenever a ApiKey is added, updated or deleted.

Signature

class ApiKeyEvent extends VendureEntityEvent<ApiKey, ApiKeyInputTypes> {    constructor(ctx: RequestContext, entity: ApiKey, type: 'created' | 'updated' | 'deleted', input?: ApiKeyInputTypes)}

Extends: VendureEntityEvent<ApiKey, ApiKeyInputTypes>

AssetChannelEvent

@vendure/core Source

This event is fired whenever an Asset is assigned or removed From a channel.

Signature

class AssetChannelEvent extends VendureEvent {    constructor(ctx: RequestContext, asset: Asset, channelId: ID, type: 'assigned' | 'removed')}

Extends: VendureEvent

AssetEvent

@vendure/core Sourcev1.4

This event is fired whenever a Asset is added, updated or deleted.

Signature

class AssetEvent extends VendureEntityEvent<Asset, AssetInputTypes> {    constructor(ctx: RequestContext, entity: Asset, type: 'created' | 'updated' | 'deleted', input?: AssetInputTypes)    asset: Asset}

Extends: VendureEntityEvent<Asset, AssetInputTypes>

asset

propertyAssetv1.4

AttemptedLoginEvent

@vendure/core Source

This event is fired when an attempt is made to log in via the shop or admin API login mutation. The strategy represents the name of the AuthenticationStrategy used in the login attempt. If the "native" strategy is used, the additional identifier property will be available.

Signature

class AttemptedLoginEvent extends VendureEvent {    constructor(ctx: RequestContext, strategy: string, identifier?: string)}

Extends: VendureEvent

BootstrappedEvent

@vendure/core Sourcev3.5.6

This event is fired when vendure finished bootstrapping. For the server and worker process, this happens after the welcome message is logged.

Use this event to preload data into the cache or perform other startup logic that would otherwise * block the bootstrapping process and slow down server start time. To avoid missing this event, subscribers should be registered during module initialization (for example in OnApplicationBootstrap), not after bootstrap\(\) resolves.

Signature

class BootstrappedEvent extends VendureEvent {    constructor()}

Extends: VendureEvent

ChangeChannelEvent

@vendure/core Sourcev1.4

This event is fired whenever an ChannelAware entity is assigned or removed from a channel. The entity property contains the value before updating the channels.

Signature

class ChangeChannelEvent<T extends ChannelAware & VendureEntity> extends VendureEvent {    constructor(ctx: RequestContext, entity: T, channelIds: ID[], type: 'assigned' | 'removed', entityType?: Type<T>)}

Extends: VendureEvent

ChannelEvent

@vendure/core Sourcev1.4

This event is fired whenever a Channel is added, updated or deleted.

Signature

class ChannelEvent extends VendureEntityEvent<Channel, ChannelInputTypes> {    constructor(ctx: RequestContext, entity: Channel, type: 'created' | 'updated' | 'deleted', input?: ChannelInputTypes)}

Extends: VendureEntityEvent<Channel, ChannelInputTypes>

CollectionEvent

@vendure/core Sourcev1.4

This event is fired whenever a Collection is added, updated or deleted.

Signature

class CollectionEvent extends VendureEntityEvent<Collection, CollectionInputTypes> {    constructor(ctx: RequestContext, entity: Collection, type: 'created' | 'updated' | 'deleted', input?: CollectionInputTypes)}

Extends: VendureEntityEvent<Collection, CollectionInputTypes>

CollectionModificationEvent

@vendure/core Source

This event is fired whenever a Collection is modified in some way. The productVariantIds argument is an array of ids of all ProductVariants which:

were part of this collection prior to modification and are no longer
are now part of this collection after modification but were not before

Signature

class CollectionModificationEvent extends VendureEvent {    constructor(ctx: RequestContext, collection: Collection, productVariantIds: ID[])}

Extends: VendureEvent

CountryEvent

@vendure/core Sourcev1.4

This event is fired whenever a Country is added, updated or deleted.

Signature

class CountryEvent extends VendureEntityEvent<Country, CountryInputTypes> {    constructor(ctx: RequestContext, entity: Country, type: 'created' | 'updated' | 'deleted', input?: CountryInputTypes)}

Extends: VendureEntityEvent<Country, CountryInputTypes>

CouponCodeEvent

@vendure/core Sourcev1.4

This event is fired whenever an coupon code of an active Promotion is assigned or removed to an Order.

Signature

class CouponCodeEvent extends VendureEvent {    constructor(ctx: RequestContext, couponCode: string, orderId: ID, type: 'assigned' | 'removed')}

Extends: VendureEvent

CustomerAddressEvent

@vendure/core Sourcev1.4

This event is fired whenever a Address is added, updated or deleted.

Signature

class CustomerAddressEvent extends VendureEntityEvent<Address, CustomerAddressInputTypes> {    constructor(ctx: RequestContext, entity: Address, type: 'created' | 'updated' | 'deleted', input?: CustomerAddressInputTypes)    address: Address}

Extends: VendureEntityEvent<Address, CustomerAddressInputTypes>

address

propertyAddress

CustomerEvent

@vendure/core Source

This event is fired whenever a Customer is added, updated or deleted.

Signature

class CustomerEvent extends VendureEntityEvent<Customer, CustomerInputTypes> {    constructor(ctx: RequestContext, entity: Customer, type: 'created' | 'updated' | 'deleted', input?: CustomerInputTypes)    customer: Customer}

Extends: VendureEntityEvent<Customer, CustomerInputTypes>

customer

propertyCustomerv1.4

CustomerGroupChangeEvent

@vendure/core Sourcev1.4

This event is fired whenever one or more Customer is assigned to or removed from a CustomerGroup.

Signature

class CustomerGroupChangeEvent extends VendureEvent {    constructor(ctx: RequestContext, customers: Customer[], customGroup: CustomerGroup, type: 'assigned' | 'removed')}

Extends: VendureEvent

CustomerGroupEvent

@vendure/core Sourcev1.4

This event is fired whenever a CustomerGroup is added, updated or deleted.

Signature

class CustomerGroupEvent extends VendureEntityEvent<CustomerGroup, CustomerGroupInputTypes> {    constructor(ctx: RequestContext, entity: CustomerGroup, type: 'created' | 'updated' | 'deleted', input?: CustomerGroupInputTypes)}

Extends: VendureEntityEvent<CustomerGroup, CustomerGroupInputTypes>

FacetEvent

@vendure/core Sourcev1.4

This event is fired whenever a Facet is added, updated or deleted.

Signature

class FacetEvent extends VendureEntityEvent<Facet, FacetInputTypes> {    constructor(ctx: RequestContext, entity: Facet, type: 'created' | 'updated' | 'deleted', input?: FacetInputTypes)}

Extends: VendureEntityEvent<Facet, FacetInputTypes>

FacetValueEvent

@vendure/core Sourcev1.4

This event is fired whenever a FacetValue is added, updated or deleted.

Signature

class FacetValueEvent extends VendureEntityEvent<FacetValue, FacetValueInputTypes> {    constructor(ctx: RequestContext, entity: FacetValue, type: 'created' | 'updated' | 'deleted', input?: FacetValueInputTypes)}

Extends: VendureEntityEvent<FacetValue, FacetValueInputTypes>

FulfillmentEvent

@vendure/core Sourcev1.4

This event is fired whenever a Fulfillment is added. The type is always created.

Signature

class FulfillmentEvent extends VendureEntityEvent<Fulfillment, CreateFulfillmentInput> {    constructor(ctx: RequestContext, entity: Fulfillment, input?: CreateFulfillmentInput)}

Extends: VendureEntityEvent<Fulfillment, CreateFulfillmentInput>

FulfillmentStateTransitionEvent

@vendure/core Source

This event is fired whenever an Fulfillment transitions from one FulfillmentState to another.

Signature

class FulfillmentStateTransitionEvent extends VendureEvent {    constructor(fromState: FulfillmentState, toState: FulfillmentState, ctx: RequestContext, fulfillment: Fulfillment)}

Extends: VendureEvent

GlobalSettingsEvent

@vendure/core Sourcev1.4

This event is fired whenever a GlobalSettings is added. The type is always updated, because it's only created once and never deleted.

Signature

class GlobalSettingsEvent extends VendureEntityEvent<GlobalSettings, UpdateGlobalSettingsInput> {    constructor(ctx: RequestContext, entity: GlobalSettings, input?: UpdateGlobalSettingsInput)}

Extends: VendureEntityEvent<GlobalSettings, UpdateGlobalSettingsInput>

HistoryEntryEvent

@vendure/core Sourcev1.4

This event is fired whenever one HistoryEntry is added, updated or deleted.

Signature

class HistoryEntryEvent extends VendureEntityEvent<HistoryEntry, HistoryInput> {    public readonly historyType: 'order' | 'customer' | string;    constructor(ctx: RequestContext, entity: HistoryEntry, type: 'created' | 'updated' | 'deleted', historyType: 'order' | 'customer' | string, input?: HistoryInput)}

Extends: VendureEntityEvent<HistoryEntry, HistoryInput>

historyType

property'order' | 'customer' | string

IdentifierChangeEvent

@vendure/core Source

This event is fired when a registered user successfully changes the identifier (ie email address) associated with their account.

Signature

class IdentifierChangeEvent extends VendureEvent {    constructor(ctx: RequestContext, user: User, oldIdentifier: string)}

Extends: VendureEvent

IdentifierChangeRequestEvent

@vendure/core Source

This event is fired when a registered user requests to update the identifier (ie email address) associated with the account.

Signature

class IdentifierChangeRequestEvent extends VendureEvent {    constructor(ctx: RequestContext, user: User)}

Extends: VendureEvent

InitializerEvent

@vendure/core Sourcev1.7.0

This event is fired when vendure finished initializing its services inside the InitializerService

Signature

class InitializerEvent extends VendureEvent {    constructor()}

Extends: VendureEvent

LoginEvent

@vendure/core Source

This event is fired when a user successfully logs in via the shop or admin API login mutation.

Signature

class LoginEvent extends VendureEvent {    constructor(ctx: RequestContext, user: User)}

Extends: VendureEvent

LogoutEvent

@vendure/core Source

This event is fired when a user logs out via the shop or admin API logout mutation.

Signature

class LogoutEvent extends VendureEvent {    constructor(ctx: RequestContext)}

Extends: VendureEvent

OrderEvent

@vendure/core Source

This event is fired whenever an Order is added, updated or deleted.

Signature

class OrderEvent extends VendureEntityEvent<Order, OrderInputTypes> {    constructor(ctx: RequestContext, order: Order, type: 'created' | 'updated' | 'deleted', input?: OrderInputTypes)    order: Order}

Extends: VendureEntityEvent<Order, OrderInputTypes>

order

propertyOrderv3.4.0

OrderLineEvent

@vendure/core Source

This event is fired whenever an OrderLine is added, updated or deleted.

Signature

class OrderLineEvent extends VendureEvent {    constructor(ctx: RequestContext, order: Order, orderLine: OrderLine, type: 'created' | 'updated' | 'deleted' | 'cancelled')}

Extends: VendureEvent

OrderPlacedEvent

@vendure/core Source

This event is fired whenever an Order is set as "placed", which by default is when it transitions from 'ArrangingPayment' to either 'PaymentAuthorized' or 'PaymentSettled'.

Note that the exact point that it is set as "placed" can be configured according to the OrderPlacedStrategy.

Signature

class OrderPlacedEvent extends VendureEvent {    constructor(fromState: OrderState, toState: OrderState, ctx: RequestContext, order: Order)}

Extends: VendureEvent

OrderStateTransitionEvent

@vendure/core Source

This event is fired whenever an Order transitions from one OrderState to another.

Signature

class OrderStateTransitionEvent extends VendureEvent {    constructor(fromState: OrderState, toState: OrderState, ctx: RequestContext, order: Order)}

Extends: VendureEvent

PasswordResetEvent

@vendure/core Source

This event is fired when a Customer requests a password reset email.

Signature

class PasswordResetEvent extends VendureEvent {    constructor(ctx: RequestContext, user: User)}

Extends: VendureEvent

PasswordResetVerifiedEvent

@vendure/core Sourcev1.4

This event is fired when a password reset is executed with a verified token.

Signature

class PasswordResetVerifiedEvent extends VendureEvent {    constructor(ctx: RequestContext, user: User)}

Extends: VendureEvent

PaymentMethodEvent

@vendure/core Source

This event is fired whenever a PaymentMethod is added, updated or deleted.

Signature

class PaymentMethodEvent extends VendureEntityEvent<PaymentMethod, PaymentMethodInputTypes> {    constructor(ctx: RequestContext, entity: PaymentMethod, type: 'created' | 'updated' | 'deleted', input?: PaymentMethodInputTypes)}

Extends: VendureEntityEvent<PaymentMethod, PaymentMethodInputTypes>

PaymentStateTransitionEvent

@vendure/core Source

This event is fired whenever a Payment transitions from one PaymentState to another, e.g. a Payment is authorized by the payment provider.

Signature

class PaymentStateTransitionEvent extends VendureEvent {    constructor(fromState: PaymentState, toState: PaymentState, ctx: RequestContext, payment: Payment, order: Order)}

Extends: VendureEvent

ProductChannelEvent

@vendure/core Source

This event is fired whenever a Product is added, updated or deleted.

Signature

class ProductChannelEvent extends VendureEvent {    constructor(ctx: RequestContext, product: Product, channelId: ID, type: 'assigned' | 'removed')}

Extends: VendureEvent

ProductEvent

@vendure/core Source

This event is fired whenever a Product is added, updated or deleted.

Signature

class ProductEvent extends VendureEntityEvent<Product, ProductInputTypes> {    constructor(ctx: RequestContext, entity: Product, type: 'created' | 'updated' | 'deleted', input?: ProductInputTypes)    product: Product}

Extends: VendureEntityEvent<Product, ProductInputTypes>

product

propertyProductv1.4

ProductOptionEvent

@vendure/core Sourcev1.4

This event is fired whenever a ProductOption is added or updated.

Signature

class ProductOptionEvent extends VendureEntityEvent<ProductOption, ProductOptionInputTypes> {    constructor(ctx: RequestContext, entity: ProductOption, type: 'created' | 'updated' | 'deleted', input?: ProductOptionInputTypes)}

Extends: VendureEntityEvent<ProductOption, ProductOptionInputTypes>

ProductOptionGroupChangeEvent

@vendure/core Sourcev1.4

This event is fired whenever a ProductOptionGroup is assigned or removed from a Product.

Signature

class ProductOptionGroupChangeEvent extends VendureEvent {    constructor(ctx: RequestContext, product: Product, optionGroupId: ID, type: 'assigned' | 'removed')}

Extends: VendureEvent

ProductOptionGroupEvent

@vendure/core Sourcev1.4

This event is fired whenever a ProductOptionGroup is added or updated.

Signature

class ProductOptionGroupEvent extends VendureEntityEvent<    ProductOptionGroup,    ProductOptionGroupInputTypes> {    constructor(ctx: RequestContext, entity: ProductOptionGroup, type: 'created' | 'updated' | 'deleted', input?: ProductOptionGroupInputTypes)}

Extends: VendureEntityEvent< ProductOptionGroup, ProductOptionGroupInputTypes >

ProductVariantChannelEvent

@vendure/core Source

This event is fired whenever a ProductVariant is assigned or removed from a Channel.

Signature

class ProductVariantChannelEvent extends VendureEvent {    constructor(ctx: RequestContext, productVariant: ProductVariant, channelId: ID, type: 'assigned' | 'removed')}

Extends: VendureEvent

ProductVariantEvent

@vendure/core Source

This event is fired whenever a ProductVariant is added, updated or deleted.

Signature

class ProductVariantEvent extends VendureEntityEvent<ProductVariant[], ProductVariantInputTypes> {    constructor(ctx: RequestContext, entity: ProductVariant[], type: 'created' | 'updated' | 'deleted', input?: ProductVariantInputTypes)    variants: ProductVariant[]}

Extends: VendureEntityEvent<ProductVariant[], ProductVariantInputTypes>

variants

propertyProductVariant[]v1.4

ProductVariantPriceEvent

@vendure/core Sourcev2.2.0

This event is fired whenever a ProductVariantPrice is added, updated or deleted.

Signature

class ProductVariantPriceEvent extends VendureEntityEvent<    ProductVariantPrice[],    ProductVariantInputTypes> {    constructor(ctx: RequestContext, entity: ProductVariantPrice[], type: 'created' | 'updated' | 'deleted', input?: ProductVariantInputTypes)}

Extends: VendureEntityEvent< ProductVariantPrice[], ProductVariantInputTypes >

PromotionEvent

@vendure/core Source

This event is fired whenever a Promotion is added, updated or deleted.

Signature

class PromotionEvent extends VendureEntityEvent<Promotion, PromotionInputTypes> {    constructor(ctx: RequestContext, entity: Promotion, type: 'created' | 'updated' | 'deleted', input?: PromotionInputTypes)}

Extends: VendureEntityEvent<Promotion, PromotionInputTypes>

ProvinceEvent

@vendure/core Sourcev2.0

This event is fired whenever a Province is added, updated or deleted.

Signature

class ProvinceEvent extends VendureEntityEvent<Province, ProvinceInputTypes> {    constructor(ctx: RequestContext, entity: Province, type: 'created' | 'updated' | 'deleted', input?: ProvinceInputTypes)}

Extends: VendureEntityEvent<Province, ProvinceInputTypes>

RefundEvent

@vendure/core Source

This event is fired whenever a Refund is created

Signature

class RefundEvent extends VendureEvent {    constructor(ctx: RequestContext, order: Order, refund: Refund, type: 'created')}

Extends: VendureEvent

RefundStateTransitionEvent

@vendure/core Source

This event is fired whenever a Refund transitions from one RefundState to another.

Signature

class RefundStateTransitionEvent extends VendureEvent {    constructor(fromState: RefundState, toState: RefundState, ctx: RequestContext, refund: Refund, order: Order)}

Extends: VendureEvent

RoleChangeEvent

@vendure/core Sourcev1.4

This event is fired whenever one Role is assigned or removed from a user. The property roleIds only contains the removed or assigned role ids.

Signature

class RoleChangeEvent extends VendureEvent {    constructor(ctx: RequestContext, admin: Administrator, roleIds: ID[], type: 'assigned' | 'removed')}

Extends: VendureEvent

RoleEvent

@vendure/core Sourcev1.4

This event is fired whenever one Role is added, updated or deleted.

Signature

class RoleEvent extends VendureEntityEvent<Role, RoleInputTypes> {    constructor(ctx: RequestContext, entity: Role, type: 'created' | 'updated' | 'deleted', input?: RoleInputTypes)}

Extends: VendureEntityEvent<Role, RoleInputTypes>

SearchEvent

@vendure/core Sourcev1.6.0

This event is fired whenever a search query is executed.

Signature

class SearchEvent extends VendureEvent {    constructor(ctx: RequestContext, input: ExtendedSearchInput)}

Extends: VendureEvent

SellerEvent

@vendure/core Sourcev2.0.1

This event is fired whenever one Seller is added, updated or deleted.

Signature

class SellerEvent extends VendureEntityEvent<Seller, SellerInputTypes> {    constructor(ctx: RequestContext, entity: Seller, type: 'created' | 'updated' | 'deleted', input?: SellerInputTypes)}

Extends: VendureEntityEvent<Seller, SellerInputTypes>

ShippingMethodEvent

@vendure/core Source

This event is fired whenever a ShippingMethod is added, updated or deleted.

Signature

class ShippingMethodEvent extends VendureEntityEvent<ShippingMethod, ShippingMethodInputTypes> {    constructor(ctx: RequestContext, entity: ShippingMethod, type: 'created' | 'updated' | 'deleted', input?: ShippingMethodInputTypes)}

Extends: VendureEntityEvent<ShippingMethod, ShippingMethodInputTypes>

StockLocationEvent

@vendure/core Source

This event is fired whenever a StockLocation is added, updated or deleted.

Signature

class StockLocationEvent extends VendureEntityEvent<StockLocation, StockLocationInputTypes> {    constructor(ctx: RequestContext, entity: StockLocation, type: 'created' | 'updated' | 'deleted', input?: StockLocationInputTypes)}

Extends: VendureEntityEvent<StockLocation, StockLocationInputTypes>

StockMovementEvent

@vendure/core Sourcev1.1.0

This event is fired whenever a StockMovement entity is created, which occurs when the saleable stock level of a ProductVariant is altered due to things like sales, manual adjustments, and cancellations.

Signature

class StockMovementEvent extends VendureEvent {    public readonly type: StockMovementType;    constructor(ctx: RequestContext, stockMovements: StockMovement[])}

Extends: VendureEvent

type

propertyStockMovementType

TaxCategoryEvent

@vendure/core Source

This event is fired whenever a TaxCategory is added, updated or deleted.

Signature

class TaxCategoryEvent extends VendureEntityEvent<TaxCategory, TaxCategoryInputTypes> {    constructor(ctx: RequestContext, entity: TaxCategory, type: 'created' | 'updated' | 'deleted', input?: TaxCategoryInputTypes)}

Extends: VendureEntityEvent<TaxCategory, TaxCategoryInputTypes>

TaxRateEvent

@vendure/core Source

This event is fired whenever a TaxRate is added, updated or deleted.

Signature

class TaxRateEvent extends VendureEntityEvent<TaxRate, TaxRateInputTypes> {    constructor(ctx: RequestContext, entity: TaxRate, type: 'created' | 'updated' | 'deleted', input?: TaxRateInputTypes)}

Extends: VendureEntityEvent<TaxRate, TaxRateInputTypes>

TaxRateModificationEvent

@vendure/core Source

This event is fired whenever a TaxRate is changed

Signature

class TaxRateModificationEvent extends VendureEvent {    constructor(ctx: RequestContext, taxRate: TaxRate)}

Extends: VendureEvent

ZoneEvent

@vendure/core Source

This event is fired whenever a Zone is added, updated or deleted.

Signature

class ZoneEvent extends VendureEntityEvent<Zone, ZoneInputTypes> {    constructor(ctx: RequestContext, entity: Zone, type: 'created' | 'updated' | 'deleted', input?: ZoneInputTypes)}

Extends: VendureEntityEvent<Zone, ZoneInputTypes>

ZoneMembersEvent

@vendure/core Source

This event is fired whenever a Zone gets Country members assigned or removed The entity property contains the zone with the already updated member field.

Signature

class ZoneMembersEvent extends VendureEvent {    constructor(ctx: RequestContext, entity: Zone, type: 'assigned' | 'removed', memberIds: ID[])}

Extends: VendureEvent

Was this chapter helpful?

Report Issue

Edited Apr 20, 2026·Edit this page