--- title: Reference - Global system events --- > Agent instructions: > **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown. > > - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version. > - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt). Event categories (classes): ## ObjectEvents **Namespace**: CMS.DataEngine Contains events that occur for all types of objects in the system. See also: [Handling object events](https://docs.kentico.com/13/custom-development/handling-global-events/handling-object-events.md) > **Note:** **Important** > > Use the following classes to access the object events in the API: > > - **ObjectEvents** – events triggered for all object types > - **Info.TYPEINFO.Events** – events triggered only for a specific object type, for example: _UserInfo.TYPEINFO.Events_ | Event | Event types | Handler parameters | Description | | ---------------- | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Insert | Before
After
Failure | ObjectEventArgs
**Properties**
Object (BaseInfo) | Occurs when a new object is created.
To reliably handle all possible object creation events, you may also need to assign a matching handler to the **BulkInsert** event. The system triggers the _BulkInsert_ event instead of _Insert_ in certain cases, particularly for operations that can affect multiple objects. | | Update | Before
After
Failure | ObjectEventArgs
**Properties**
Object (BaseInfo) | Occurs when the data of an existing object is updated.
To reliably handle all possible object update events, you may also need to assign a matching handler to the **BulkUpdate** event. The system triggers the _BulkUpdate_ event instead of _Update_ in certain cases, particularly for operations that can affect multiple objects. | | Delete | Before
After
Failure | ObjectEventArgs
**Properties**
Object (BaseInfo) | Occurs when an object is deleted.
To reliably handle all possible object deletion events, you may also need to assign a matching handler to the **BulkDelete** event. The system triggers the _BulkDelete_ event instead of _Delete_ in certain cases, particularly for operations that can affect multiple objects. | | BulkInsert | Before
After
Failure | BulkInsertEventArgs
**Properties**
InsertedObjects (IEnumerable)
TypeInfo (ObjectTypeInfo) | Occurs when the system performs object creation operations that can affect multiple objects. To reliably handle all possible object creation events, assign matching handlers to both the **BulkInsert** and **Insert** events.
In certain cases, the system creates objects by directly inserting data into a database table (for example when [importing contacts](https://docs.kentico.com/13/on-line-marketing-features/managing-your-on-line-marketing-features/contact-management/working-with-contacts/importing-contacts.md) from CSV files). To cover these scenarios, you also need to assign an appropriate handler to the **SqlEvents.BulkInsert** event. | | BulkUpdate | Before
After
Failure | BulkUpdateEventArgs
**Properties**
ChangedColumns (IEnumerable)
TypeInfo (ObjectTypeInfo)
WhereCondition (IWhereCondition) | Occurs when the system performs object update operations that can affect multiple objects. To reliably handle all possible object update events, assign matching handlers to both the **BulkUpdate** and **Update** events. | | BulkDelete | Before
After
Failure | BulkDeleteEventArgs
**Properties**
TypeInfo (ObjectTypeInfo)
WhereCondition (IWhereCondition) | Occurs when the system performs object deletion operations that can affect multiple objects. To reliably handle all possible object deletion events, assign matching handlers to both the **BulkDelete** and **Delete** events. | | GetContent | Execute | ObjectEventArgs
**Properties**
Content (string)
Object (BaseInfo) | Occurs before the system writes an object's data into [smart search indexes](https://docs.kentico.com/13/configuring-xperience/setting-up-search-on-your-website.md) (when building or updating indexes).
Allows you to determine exactly how search indexes store object content.
**Example**: [Customizing the content of search indexes](https://docs.kentico.com/13/configuring-xperience/setting-up-search-on-your-website/customizing-the-content-of-search-indexes.md) | | LogChange | Before
After
Failure | LogObjectChangeEventArgs
**Properties**
Settings (LogObjectChangeSettings) | Occurs when the system logs object changes for the purposes of staging and integration. For example, allows you to exclude specific objects from staging.
**Example**: [Excluding content from staging and integration](https://docs.kentico.com/13/custom-development/handling-global-events/excluding-content-from-staging-and-integration.md) | | CheckPermissions | Before
After
Failure | ObjectSecurityEventArgs
**Properties**
Object (BaseInfo)
Permission (PermissionsEnum)
User (UserInfo)
SiteName (string)
Result (AuthorizationResultEnum) | Occurs when the system checks [permissions](https://docs.kentico.com/13/managing-users/configuring-permissions.md) for objects of the given type. | | Sort | Before
After
Failure | ObjectSortEventArgs
**Properties**
Object (BaseInfo)
Ascending (bool)
OrderColumn (string)
NameColumn (string) | Occurs when sorting of objects is requested. | | ChangeOrder | Before
After
Failure | ObjectChangeOrderEventArgs
**Properties**
Object (BaseInfo)
NewOrder (int)
RelativeOrder (int)
OrderColumn (string) | Occurs when a change in the order of objects is requested. | | GetData | Before
After
Failure | ObjectDataEventArgs
**Properties**
Data (DataSet)
Query (IObjectQuery)
TotalRecords (int) | Occurs when the system retrieves object data using the ObjectQuery API.
The **Before** event type is suitable, for example, when you want to retrieve data from an external source. Assign the external data into the **Data** property of the handler's _ObjectDataEventArgs_ parameter, which is empty by default in the Before event.
Use the **After** event type if you need to edit the data retrieved from Xperience in the **Data** property.
The **TotalRecords** property provides a number of total records in case paging is used. Use _-1_ to use the rows count of the **Data** property. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## DocumentEvents **Namespace**: CMS.DocumentEngine Contains events fired when changes are made to pages. > **Note:** **Note**: > > Pages under [workflow](https://docs.kentico.com/13/configuring-xperience/configuring-the-environment-for-content-editors/configuring-workflows.md) require a different approach to event handling. Use the events from the [WorkflowEvents](#workflowevents) class instead of _DocumentEvents._ > > For example, to handle the 'update' action for a page under workflow, use the _SaveVersion_ event from _WorkflowEvents_ instead of the _DocumentEvents.Update_ event. | Event | Event types | Handler parameters | Description | | -------------------------- | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Insert | Before
After
Failure | DocumentEventArgs
**Properties**
TargetParentNodeID (int)
Node (TreeNode)
TreeProvider (TreeProvider) | Occurs when a new page is created. | | InsertNewCulture | Before
After
Failure | DocumentEventArgs
**Properties**
Node (TreeNode)
TreeProvider (TreeProvider) | Occurs when a new culture version is created for a page. | | InsertLink | Before
After
Failure | DocumentEventArgs
**Properties**
TargetParentNodeID (int)
Node (TreeNode)
TreeProvider (TreeProvider) | Occurs when creating new [linked pages](https://docs.kentico.com/13/managing-website-content/working-with-pages/copying-and-moving-pages-creating-linked-pages.md). | | Update | Before
After
Failure | DocumentEventArgs
**Properties**
Node (TreeNode)
TreeProvider (TreeProvider) | Occurs when an existing page is updated. | | Move | Before
After
Failure | DocumentEventArgs
**Properties**
TargetParentNodeID (int)
Node (TreeNode)
TreeProvider (TreeProvider) | Occurs when a page is moved to a different position in the site's content tree. | | Copy | Before
After
Failure | DocumentEventArgs
**Properties**
TargetParentNodeID (int)
IncludeChildren (bool)
Node (TreeNode)
TreeProvider (TreeProvider) | Occurs when a new copy of a page is created. | | Delete | Before
After
Failure | DocumentEventArgs
**Properties**
Node (TreeNode)
TreeProvider (TreeProvider) | Occurs when a page is deleted. | | LogChange | Before
After
Failure | LogDocumentChangeEventArgs
**Properties**
Settings (LogDocumentChangeSettings) | Occurs when the system logs page changes for the purposes of staging and integration. For example, allows you to exclude specific pages from staging.
**Example**: [Excluding content from staging and integration](https://docs.kentico.com/13/custom-development/handling-global-events/excluding-content-from-staging-and-integration.md) | | CheckPermissions | Before
After
Failure | DocumentSecurityEventArgs
**Properties**
Node (TreeNode)
Permission (PermissionsEnum)
User (UserInfo)
SiteName (string)
Result (AuthorizationResultEnum) | Occurs when the system checks [permissions](https://docs.kentico.com/13/managing-users/configuring-permissions/configuring-page-permissions.md) for pages.
**Note**: This event does not occur on the live site. For checking permissions on the live site, see the [AuthorizeDocument ](#referenceglobalsystemevents-authorizedocument)event. | | Sort | Before
After
Failure | DocumentSortEventArgs
**Properties**
ParentNodeId (int)
Ascending (bool)
SortType (DocumentSortEnum) | Occurs when sorting of pages is requested. | | ChangeOrder | Before
After
Failure | DocumentChangeOrderEventArgs
**Properties**
Node (TreeNode)
NewOrder (int?)
RelativeOrder (bool)
OrderType (DocumentOrderEnum) | Occurs when a change in the order of pages is requested. | | GetData | Before
After
Failure | DocumentDataEventArgs
**Properties**
Data (DataSet)
Query (IDocumentQuery)
TotalRecords (int) | Occurs when the system retrieves page data using the DocumentQuery API.
The **Before** event type is suitable, for example, when you want to retrieve data from an external source. Assign the external data into the **Data** property of the handler's _DocumentDataEventArgs_ parameter, which is empty by default in the Before event.
Use the **After** event type, when you want to edit the data retrieved from Xperience in the **Data** property.
The **TotalRecords** property provides a number of total records in case paging is used. Use _-1_ to use rows count of the **Data** property. | | Search | | | | | CreateSearchFields | Execute | CreateSearchFieldsEventArgs
**Properties**
Fields (IList)
IndexInfo (ISearchIndexInfo)
IndexDataSource (SearchIndexDataSourceEnum)
SearchFields (IEnumerable) | Occurs while (re)building a [locally stored search index](https://docs.kentico.com/13/configuring-xperience/setting-up-search-on-your-website/using-locally-stored-search-indexes.md) of the **Pages** type when the system prepares the collection of search fields.
Allows developers to add custom search fields to indexes. Such fields must be added via the **Fields** property of the handler's _CreateSearchFieldsEventArgs_ parameter.
Values for the custom fields can be assigned for individual pages by handling the **CreateSearchFieldsForPage** event.
**Example**: [Customizing the content of search indexes](https://docs.kentico.com/13/configuring-xperience/setting-up-search-on-your-website/customizing-the-content-of-search-indexes.md) | | CreateSearchFieldsForPage | Execute | CreateSearchFieldsForPageEventArgs
**Properties**
Fields (IList)
IndexInfo (ISearchIndexInfo)
IndexDataSource (SearchIndexDataSourceEnum)
Page (TreeNode)
SearchFields (IEnumerable) | Occurs when the system indexes or updates a page for a [locally stored search index](https://docs.kentico.com/13/configuring-xperience/setting-up-search-on-your-website/using-locally-stored-search-indexes.md) of the **Pages** type. The event triggers separately for each indexed page.
Allows developers to add custom search fields to indexes and set their value for individual pages. Such fields must be added via the **Fields** property of the handler's _CreateSearchFieldsForPageEventArgs_ parameter. Set field values using the **Value** property of the added _ISearchField_ object.
**Important**: Any custom fields must first be registered into your indexes by handling the **CreateSearchFields** event.
**Example**: [Customizing the content of search indexes](https://docs.kentico.com/13/configuring-xperience/setting-up-search-on-your-website/customizing-the-content-of-search-indexes.md) | | GetContent | Execute | DocumentSearchEventArgs
**Properties**
Content (string)
Node (TreeNode)
Settings (SearchIndexSettingsInfo)
IndexInfo (ISearchIndexInfo)
SearchDocument (ISearchDocument)
IsCrawler (bool) | Occurs before the system writes a page's data into a search index (when building or updating indexes).
Allows you to determine exactly how search indexes store page content.
**Examples**: [Customizing the content of search indexes](https://docs.kentico.com/13/configuring-xperience/setting-up-search-on-your-website/customizing-the-content-of-search-indexes.md) | | Page attachments | | | | | SaveAttachment | Before
After
Failure | DocumentEventArgs
**Properties**
Attachment (DocumentAttachment)
Node (TreeNode)
TreeProvider (TreeProvider) | Occurs when a file attachment is added to a page or updated. | | DeleteAttachment | Before
After
Failure | DocumentEventArgs
**Properties**
Attachment (DocumentAttachment)
Node (TreeNode)
TreeProvider (TreeProvider) | Occurs when a file attachment is removed from a page. | | Page security | | | | | AuthorizeDocument | Execute | DocumentAuthorizationEventArgs
**Properties**
User (UserInfo)
Document (TreeNode)
PermissionName (string)
AuthorizationResult (AuthorizationResultEnum) | Occurs when the system performs a security check for the permissions of a specific page.
You can modify the result of the security check by adding your own conditions and setting the **AuthorizationResult** property of the handler's _DocumentAuthorizationEventArgs_ parameter. | | FilterDataSetByPermissions | Execute | DocumentAuthorizationEventArgs
**Properties**
User (UserInfo)
Data (DataSet)
PermissionName (string) | Occurs when the system filters a set of pages according to the page permissions of a user.
You can modify the filtering by adding your own conditions and modifying the page data in the **Data** property of the handler's _DocumentAuthorizationEventArgs_ parameter. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## WorkflowEvents **Namespace**: CMS.DocumentEngine Contains events related to [workflow](https://docs.kentico.com/13/configuring-xperience/configuring-the-environment-for-content-editors/configuring-workflows.md) and [versioning](https://docs.kentico.com/13/configuring-xperience/configuring-the-environment-for-content-editors/configuring-and-using-page-versioning.md) actions. | Event | Event types | Handler parameters | Description | | ----------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Approve | Before
After
Failure | WorkflowEventArgs
**Properties**
Document (TreeNode)
PreviousStep (WorkflowStepInfo) - only in the _After_ event
TreeProvider (TreeProvider) | Occurs when a page is approved to the next step. | | Reject | Before
After
Failure | WorkflowEventArgs
**Properties**
Document (TreeNode)
PreviousStep (WorkflowStepInfo) - only in the _After_ event
TreeProvider (TreeProvider) | Occurs when a page is rejected back to a previous step | | Publish | Before
After
Failure | WorkflowEventArgs
**Properties**
Document (TreeNode)
PublishedDocument(TreeNode) - only in the _After_ event
PreviousStep (WorkflowStepInfo) - only in the _After_ event
TreeProvider (TreeProvider) | Occurs when a page reaches the published step. | | Archive | Before
After
Failure | WorkflowEventArgs
**Properties**
Document (TreeNode)
PreviousStep (WorkflowStepInfo) - only in the _After_ event
TreeProvider (TreeProvider) | Occurs when a page is archived. | | Action | Before
After
Failure | WorkflowActionEventArgs
Requires references to:
CMS.WorkflowEngine
CMS.DataEngine | Occurs when executing [advanced workflow action steps](https://docs.kentico.com/13/configuring-xperience/configuring-the-environment-for-content-editors/configuring-workflows/designing-advanced-workflows/adding-action-steps-in-advanced-workflows.md). | | Page versioning | | | | | SaveVersion | Before
After
Failure | WorkflowEventArgs
**Properties**
Document (TreeNode)
VersionHistory (VersionHistoryInfo)
VersionNumber (string)
VersionComment (string)
TreeProvider (TreeProvider) | Occurs when the edited version of a page is updated. | | SaveAttachmentVersion | Before
After
Failure | WorkflowEventArgs
**Properties**
Document (TreeNode)
Attachment (DocumentAttachment)
TreeProvider (TreeProvider) | Occurs when an attachment is updated or inserted for the edited version of a page. | | RemoveAttachmentVersion | Before
After
Failure | WorkflowEventArgs
**Properties**
Document (TreeNode)
Attachment (DocumentAttachment)
TreeProvider (TreeProvider) | Occurs when an attachment is removed for the edited version of a page. | | Content locking | | | | | CheckOut | Before
After
Failure | WorkflowEventArgs
**Properties**
Document (TreeNode)
TreeProvider (TreeProvider) | Occurs when a page is checked-out. | | CheckIn | Before
After
Failure | WorkflowEventArgs
**Properties**
Document (TreeNode)
TreeProvider (TreeProvider) | Occurs when a page is checked-in. | | UndoCheckOut | Before
After
Failure | WorkflowEventArgs
**Properties**
Document (TreeNode)
TreeProvider (TreeProvider) | Occurs when a user performs the undo check-out action. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## SecurityEvents **Namespace**: CMS.Membership Contains security and authentication events for the Xperience administration interface. > **Note:** **Note**: _SecurityEvents_ are only raised for the Xperience administration interface. The events do not occur when users sign in or out on the live site, which uses membership functionality based on ASP.NET Identity (as described in [Integrating Xperience membership](https://docs.kentico.com/13/managing-users/user-registration-and-authentication/integrating-xperience-membership.md)). | Event | Event types | Handler parameters | Description | | ----------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Authenticate | Execute | AuthenticationEventArgs
**Properties**
User (UserInfo)
UserName (string)
Password (string)
SiteName (string) | Occurs when authenticating users into the administration interface.
**See also**: [Handling custom administration authentication](https://docs.kentico.com/13/custom-development/handling-global-events/handling-custom-administration-authentication.md) | | AuthenticationRequested | Execute | AuthenticationRequestEventArgs
**Properties**
RequestedUrl (string) | Occurs when a user accesses a restricted section of Xperience and the user's authentication is required. | | MultiFactorAuthenticate | Execute | AuthenticationEventArgs
**Properties**
User (UserInfo)
Passcode (string)
UserName (string) | Occurs when a user tries to sign in to Xperience with [multi-factor authentication](https://docs.kentico.com/13/managing-users/user-registration-and-authentication/configuring-multi-factor-authentication.md) enabled.
**See also**: [Handling custom multi-factor authentication](https://docs.kentico.com/13/custom-development/handling-global-events/handling-custom-multi-factor-authentication.md) | | AuthorizeResource | Execute | AuthorizationEventArgs
**Properties**
User (UserInfo)
ResourceName (string)
PermissionName (string)
Authorized (bool) | Occurs when checking permissions for modules. | | AuthorizeClass | Execute | AuthorizationEventArgs
**Properties**
User (UserInfo)
ClassName (string)
PermissionName (string)
Authorized (bool) | Occurs when performing security checks for object type or page type permissions. | | AuthorizeUIElement | Execute | AuthorizationEventArgs
**Properties**
User (UserInfo)
ElementName (string)
PermissionName (string)
Authorized (bool) | Occurs when checking permissions for UI elements. | | SignOut | Before
After
Failure | SignOutEventArgs
**Properties**
User (UserInfo)
SignOutUrl (string) | Occurs when a user signs out from the administration interface. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## DataProtectionEvents **Namespace**: CMS.DataProtection Contains events related to protection of personal data in the system. | Event | Event types | Handler parameters | Description | | ---------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | RevokeConsentAgreement | Execute | RevokeConsentAgreementEventArgs
**Properties**
ConsentAgreement (ConsentAgreementInfo)
Consent (ConsentInfo)
Contact (ContactInfo) | Occurs when a consent agreement is revoked. When a contact's consent agreement is revoked, this event can be used to perform custom actions, such as terminating tracking of the contact or deleting [personal data](https://docs.kentico.com/13/configuring-xperience/data-protection/gdpr-compliance/personal-data-in-xperience.md) related to the contact.
**See also**: [Creating consents](https://docs.kentico.com/13/configuring-xperience/data-protection/gdpr-compliance/creating-consents.md), [Working with consents](https://docs.kentico.com/13/configuring-xperience/data-protection/gdpr-compliance/working-with-consents.md) | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## EventLogEvents **Namespace**: CMS.EventLog Contains events that occur when logging records into the system's [event log](https://docs.kentico.com/13/developing-websites/troubleshooting-websites/working-with-the-system-event-log.md). | Event | Event types | Handler parameters | Description | | -------- | -------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | LogEvent | Before
After
Failure | LogEventArgs
**Properties**
Event (EventLogInfo) | Occurs when the system logs a record into the event log. You can use the _Before_ event to customizing the data logged for events or cancel logging for certain types of events. The _After_ event allows you to perform custom actions after events are successfully logged, for example duplicate certain types of events into a custom log.
**See also**: [Customizing event logging](https://docs.kentico.com/13/custom-development/customizing-event-logging.md) | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## StagingEvents **Namespace**: CMS.Synchronization Contains events that occur when using [content staging](https://docs.kentico.com/13/deploying-websites/content-staging.md) for pages and objects. | Event | Event types | Handler parameters | Description | | ---------------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | GetChildProcessingType | Execute | StagingChildProcessingTypeEventArgs
**Properties**
ObjectType (string)
ParentObjectType (string)
ProcessingType (IncludeToParentEnum) | Occurs on the **target server** when processing create or update staging tasks that include the data of child or binding objects (once for each child or binding type).
For example, staging tasks for roles include the data of binding objects, such as user-role and role-permission relationships. When processing a create or update staging task for a role, the _GetChildProcessingType_ event triggers separately for each binding type included in the role data.
You can use the event to customize how the system handles child and binding object data during staging. For more information, see [Customizing staging of child and binding objects](https://docs.kentico.com/13/custom-development/handling-global-events/customizing-staging-of-child-and-binding-objects.md). | | LogTask | Before
After
Failure | StagingLogTaskEventArgs
**Properties**
Object (BaseInfo)
Task (StagingTaskInfo) | Occurs when creating staging tasks on the source server after a page or object is changed in the system.
See also:
[Excluding content from staging and integration](https://docs.kentico.com/13/custom-development/handling-global-events/excluding-content-from-staging-and-integration.md)
[Automatically synchronizing staging and integration tasks](https://docs.kentico.com/13/custom-development/handling-global-events/automatically-synchronizing-staging-and-integration-tasks.md) | | Synchronize | Before
After
Failure | CMSEventArgs | Occurs on the source server when synchronizing staging tasks – once per synchronize action, even when processing multiple tasks. | | SynchronizeTask | Before
After
Failure | StagingTaskEventArgs
**Properties**
Task (StagingTaskInfo) | Occurs on the source server when synchronizing staging tasks – separately for every processed task. | | ProcessTask | Before
After
Failure | StagingSynchronizationEventArgs
**Properties**
TaskType (TaskTypeEnum)
ObjectType (string)
TaskData (DataSet)
TaskBinaryData (DataSet)
TaskHandled (bool)
SyncManager (ISyncManager) | Occurs on the **target server** when processing incoming staging tasks.
The processing of the staging tasks then also triggers the corresponding **DocumentEvents** or **ObjectEvents** (Insert, Update, Delete, etc.). | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## IntegrationEvents **Namespace**: CMS.Synchronization Contains events that occur when synchronizing pages or objects between Xperience and other applications using the [integration bus](https://docs.kentico.com/13/integrating-3rd-party-systems/using-the-integration-bus.md). See also: - [Excluding content from staging and integration](https://docs.kentico.com/13/custom-development/handling-global-events/excluding-content-from-staging-and-integration.md) - [Automatically synchronizing staging and integration tasks](https://docs.kentico.com/13/custom-development/handling-global-events/automatically-synchronizing-staging-and-integration-tasks.md) | Event | Event types | Handler parameters | Description | | --------------- | -------------------------- | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | LogInternalTask | Before
After
Failure | IntegrationTaskEventArgs
**Properties**
Task (IntegrationTaskInfo)
Object (BaseInfo) | Occurs when creating **outgoing** integration tasks after a page or object in the system is changed. | | LogExternalTask | Before
After
Failure | IntegrationTaskEventArgs
**Properties**
Task (IntegrationTaskInfo)
Object (BaseInfo) | Occurs when the system creates **incoming** tasks provided by an integration connector. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## ImportExportEvents **Namespace**: CMS.CMSImportExport Contains events related to [import and export](https://docs.kentico.com/13/deploying-websites/exporting-and-importing-sites.md) actions. | Event | Event types | Handler parameters | Description | | -------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Import | Before
After
Failure | ImportBaseEventArgs
**Properties**
Settings (SiteImportSettings) | Occurs at the start of the import process. | | ImportObject | Before
After
Failure | ImportEventArgs
**Properties**
Settings (SiteImportSettings)
Object (BaseInfo)
ParentObject (BaseInfo)
Parameters (ImportParameters) | Occurs once for every imported object. | | ImportObjects | Before
After
Failure | ImportDataEventArgs
**Properties**
Settings (SiteImportSettings)
Data (DataSet)
ObjectType (string)
SiteObjects (bool)
ParentImported (bool) | Occurs when importing sets of objects. | | ImportBinding | Before
After
Failure | ImportEventArgs
**Properties**
Settings (SiteImportSettings)
Object (BaseInfo)
ParentObject (BaseInfo)
Parameters (ImportParameters) | Occurs once for every imported binding object. | | ImportBindings | Before
After
Failure | ImportEventArgs
**Properties**
Settings (SiteImportSettings)
Object (BaseInfo)
ParentObject (BaseInfo)
Parameters (ImportParameters) | Occurs when importing binding objects. | | ImportChild | Before
After
Failure | ImportEventArgs
**Properties**
Settings (SiteImportSettings)
Object (BaseInfo)
ParentObject (BaseInfo)
Parameters (ImportParameters) | Occurs once for every imported child object. | | ImportChildren | Before
After
Failure | ImportEventArgs
**Properties**
Settings (SiteImportSettings)
Object (BaseInfo)
ParentObject (BaseInfo)
Parameters (ImportParameters) | Occurs when importing child objects. | | GetImportData | Before
After
Failure | ImportGetDataEventArgs
**Properties**
Settings (SiteImportSettings)
Data (DataSet)
Object (BaseInfo)
ObjectType (string)
SiteObjects (bool)
SelectionOnly (bool) | Occurs when importing data. Allows you to work with the data set in the import package created for a specific object types.
Use the **Before** event type to modify the data in the import package (for example add data from an external source).
Use the **After** event type to modify the data after the import package has been loaded. | | ProcessFileOperation | Before
After
Failure | ImportProcessFileOperationEventArgs
**Properties**
Operation (FileOperation)
Settings (SiteImportSettings) | Occurs when processing file/folder operations in the import package. | | ImportCanceled | Execute | ImportBaseEventArgs
**Properties**
Settings (SiteImportSettings) | Occurs when a user cancels the import process. | | ImportError | Execute | ImportErrorEventArgs
**Properties**
Exception (Exception)
Settings (SiteImportSettings) | Fires when an error occurs during the import process. | | Event | Event types | Handler parameters | Description | | --------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Export | Before
After
Finished
Failure | ExportEventArgs
**Properties**
Settings (SiteExportSettings)
SiteObjects (bool) | Occurs at the start of the export process. | | ExportObjects | Before
After
Failure | ExportEventArgs
**Properties**
Settings (SiteExportSettings)
Data (DataSet)
ObjectType (string)
SiteObjects (bool) | Occurs when exporting objects. | | GetExportData | Before
After
Failure | ExportGetDataEventArgs
**Properties**
Settings (SiteExportSettings)
Data (DataSet)
ObjectType (string)
WhereCondition (string)
ChildData (bool)
SelectionOnly (bool)
Parameters(QueryDataParameters) | Occurs when exporting data. Allows you to work with the data set in the export package created for specific object types.
Use the **Before** event type to extract data from the export package.
Use the **After** event type to modify the data in the export package. | | SingleExportSelection | Execute | SingleExportSelectionEventArgs
**Properties**
Settings (SiteExportSettings)
InfoObject (BaseInfo)
SelectedObject (List) | Occurs when selecting related objects during single object export. Allows you to attach related objects to the export package. | | ExportCanceled | Execute | ExportBaseEventArgs
**Properties**
Settings (SiteExportSettings) | Occurs when a user cancels the export process. | | ExportError | Execute | ExportErrorEventArgs
**Properties**
Exception (Exception)
Settings (SiteExportSettings) | Fires when an error occurs during the export process. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## DocumentImportExportEvents **Namespace**: CMS.DocumentEngine Contains events related to [import and export](https://docs.kentico.com/13/deploying-websites/exporting-and-importing-sites.md) of pages. | Event | Event types | Handler parameters | Description | | --------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------ | | ExportDocuments | Before
After
Failure | DocumentsExportEventArgs
**Properties**
Settings (SiteExportSettings)
Data (DataSet)
ObjectType (string)
SiteObjects (bool) | Occurs when exporting pages. | | ImportDocument | Before
After
Failure | DocumentImportEventArgs
**Properties**
Document (TreeNode)
Settings (SiteImportSettings) | Occurs once for every imported page. | | ImportDocuments | Before
After
Failure | DocumentImportEventArgs
**Properties**
Document (TreeNode)
Settings (SiteImportSettings) | Occurs when importing pages. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## ColumnsTranslationEvents **Namespace**: CMS.DataEngine When transferring data between instances of Xperience (via [import/export](https://docs.kentico.com/13/deploying-websites/exporting-and-importing-sites.md) or [staging](https://docs.kentico.com/13/deploying-websites/content-staging.md)), the IDs of objects can differ between the environments. Xperience automatically "translates" the ID values for system objects, but not for custom objects. For example, when you stage a [custom table](https://docs.kentico.com/13/developing-websites/defining-website-content-structure/managing-custom-tables.md) or [page type](https://docs.kentico.com/13/developing-websites/defining-website-content-structure/managing-page-types.md) that contains a custom field storing object IDs, the values may not match the IDs of the objects on the target server. The _ColumnsTranslationEvents_ allow you to ensure that the IDs are translated correctly. **See also**: [Deploying objects with custom ID fields](https://docs.kentico.com/13/custom-development/handling-global-events/deploying-objects-with-custom-id-fields.md) | Event | Event types | Handler parameters | Description | | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | | RegisterRecords | Execute | ColumnsTranslationEventArgs
**Properties**
ObjectType (string)
Data (IDataContainer)
TranslationHelper (TranslationHelper) | Occurs when exporting objects. Allows you to provide additional information for the translation of custom ID fields. | | TranslateColumns | Execute | ColumnsTranslationEventArgs
**Properties**
ObjectType (string)
Data (IDataContainer)
TranslationHelper (TranslationHelper) | Occurs when importing objects. Allows you to translate the values of custom ID fields using the provided information. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## ModulePackagingEvents **Namespace**: CMS.Modules Contains events that occur when the system generates [installation packages for custom modules](https://docs.kentico.com/13/custom-development/creating-custom-modules/creating-installation-packages-for-modules.md). | Event | Event types | Handler parameters | Description | | ------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | BuildNuSpecManifest | Before
After
Failure | BuildNuSpecManifestEventArgs
**Properties**
Manifest (NuGet.Manifest)
NuSpecBuilder (CMS.Modules.NuSpecBuilder)
ResourceName (string) | Occurs when the system creates the _.nuspec_ file for module NuGet packages. The file is an XML manifest containing package metadata. See the [.nuspec reference](https://docs.microsoft.com/en-us/nuget/schema/nuspec) for more information.
The event allows you to customize the package metadata for your modules:
The **Before** event type allows you to adjust the default nuspec content via the Xperience API – use the members of the _NuSpecBuilder_ instance provided by the corresponding property of the handler's _BuildNuSpecManifestEventArgs_ parameter.
Use the **After** event type if you wish to modify or completely replace the resulting nuspec manifest, which is accessible as an instance of the _NuGet.Manifest_ class via the corresponding property of the handler's _BuildNuSpecManifestEventArgs_ parameter.
The **ResourceName** property of the handler's _BuildNuSpecManifestEventArgs_ parameter contains the code name of the module for which the package is being created. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## BizFormItemEvents **Namespace**: CMS.OnlineForms Contains events related to [form](https://docs.kentico.com/13/managing-website-content/forms.md) actions. See [Working with form data using the API](https://docs.kentico.com/13/custom-development/working-with-form-data-using-the-api.md) for an example. | Event | Event types | Handler parameters | Description | | ------ | -------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------- | | Insert | Before
After
Failure | BizFormItemEventArgs
**Properties**
Item (BizFormItem) | Occurs when inserting new form items (data records of on-line forms). | | Update | Before
After
Failure | BizFormItemEventArgs
**Properties**
Item (BizFormItem) | Occurs when updating form data records. | | Delete | Before
After
Failure | BizFormItemEventArgs
**Properties**
Item (BizFormItem) | Occurs when deleting data records from forms. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## CustomTableItemEvents **Namespace**: CMS.CustomTables Contains events related to custom table actions. See [Custom table internals and API](https://docs.kentico.com/13/developing-websites/defining-website-content-structure/managing-custom-tables/custom-table-internals-and-api.md). | Event | Event types | Handler parameters | Description | | ------ | -------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | | Insert | Before
After
Failure | CustomTableItemEventArgs
**Properties**
Item (CustomTableItem) | Occurs when inserting new custom table items (data records stored in a custom table). | | Update | Before
After
Failure | CustomTableItemEventArgs
**Properties**
Item (CustomTableItem) | Occurs when updating custom table items. | | Delete | Before
After
Failure | CustomTableItemEventArgs
**Properties**
Item (CustomTableItem) | Occurs when deleting custom table items. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## EcommerceEvents **Namespace**: CMS.Ecommerce Contains events related to the E-commerce solution. | Event | Event types | Handler parameters | Description | | -------------------------- | ----------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | NewOrderCreated | Execute | NewOrderCreatedEventArgs
**Properties**
NewOrder (OrderInfo) | Fires when a new [order](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/orders.md) is created.
The event triggers only when the order is created based on an existing shopping cart. For example, the event does not trigger if an order is created within code using the _OrderInfoProvider_ API. | | OrderPaid | Execute | OrderPaidEventArgs
**Properties**
Order (OrderInfo) | Fires when an order becomes paid. | | ProductAddedToShoppingCart | Execute | ProductAddedToCartEventArgs
**Properties**
AddedShoppingCartItem (ShoppingCartItemInfo) | Fires when a customer adds a product to their shopping cart.
The event occurs only once when multiple units of the same product are added to the cart within a single action (the _ShoppingCartItem_ object available in the event's _ProductAddedToCartEventArgs_ parameter can represent any number of product units). | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## NewsletterEvents **Namespace**: CMS.Newsletters Contains events related to [Email marketing](https://docs.kentico.com/13/on-line-marketing-features/managing-your-on-line-marketing-features/email-marketing.md). | Event | Event types | Handler parameters | Description | | --------------------------- | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | ResolveMacros | Before
After
Failure | ResolveMacrosEventArgs
**Properties**
MacroResolver (MacroResolver)
TextToResolve (string)
Newsletter (NewsletterInfo)
IssueInfo (IssueInfo) | Occurs when all email feed text macros are resolved. | | GenerateQueueItems | Before
After
Failure | GenerateQueueItemsEventArgs
**Properties**
Subscriber (SubscriberInfo)
Issue (IssueInfo)
EmailAddressBlocker (IEmailAddressBlocker)
GeneratedEmails (HashSet) | Occurs when an email feed is sent to one or more recipients. You can use this event to manually add emails to the queue for custom recipients.
Note: The _GeneratedEmails_ property is used only with Newsletter email feeds and its primary purpose is to check duplicates in the newsletter recipients. | | GeneratePreview | Before
After
Failure | GeneratePreviewEventArgs
**Properties**
Subscriber (SubscriberInfo)
Issue (IssueInfo)
PreviewHtml (string) | Occurs when an email preview is generated for a recipient. | | SubscriberUnsubscribes | Execute | UnsubscriptionEventArgs
**Properties**
Newsletter (NewsletterInfo)
Email (string)
IssueID (int?) | Occurs when a recipient unsubscribes from an email feed. | | SubscriberOpensEmail | Execute | LinksEventArgs
**Properties**
IssueInfo (IssueInfo)
NewsletterInfo (NewsletterInfo)
AdditionalParameters (NameValueCollection) | Occurs when a recipient opens an email and the open email tracking feature is enabled. | | SubscriberClicksTrackedLink | Execute | LinksEventArgs
**Properties**
IssueInfo (IssueInfo)
NewsletterInfo (NewsletterInfo)
AdditionalParameters (NameValueCollection) | Occurs when a recipient clicks an email link and the email link tracking feature is enabled. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## WebAnalyticsEvents **Namespace**: CMS.WebAnalytics | Event | Event types | Handler parameters | Description | | --------------------- | ----------- | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | CheckAnalyticsConsent | Execute | CheckAnalyticsConsentEventArgs
**Properties**
ContactId (int)
HasConsent (bool) | Occurs before the system logs any [web analytics](https://docs.kentico.com/13/on-line-marketing-features/managing-your-on-line-marketing-features/web-analytics.md) for visitors (before any processing of the visitor's personal data).
Allows you to disable logging of web analytics based on consent. Assign a handler to the event, create a condition according to your website's consent requirements, and set the **HasConsent** property of the handler's **CheckAnalyticsConsentEventArgs** parameter based on the result.
**Example**: [Logging web analytics based on consent](https://docs.kentico.com/13/configuring-xperience/data-protection/gdpr-compliance/logging-web-analytics-based-on-consent.md) | | CampaignLaunched | Execute | CMSEventArgs | Occurs when a campaign is launched (whether it was originally scheduled or launched directly). | | CampaignUTMChanged | Execute | CMSEventArgs | Occurs when the UTM parameter is changed for a campaign. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## ContactManagementEvents **Namespace**: CMS.ContactManagement | Event | Event types | Handler parameters | Description | | ------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ContactInfosDeleted | Execute | ContactinfosDeletedHandlerEventArgs
**Properties**
DeletedContactsIds (IEnumerable)
DeletedContactsGUIDs (IEnumberable) | Occurs when two or more selected contacts are deleted.
When a single contact is deleted, the _TypeInfoEvents.Delete_ event can be used on _ContactInfo.TYPEINFO_. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## ActivityEvents **Namespace**: CMS.Activities | Event | Event types | Handler parameters | Description | | ----------------------------- | -------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ActivityBulkInsertPerformed | Before
After
Failure | CMSEventArgs> | Fires when the system processes [on-line marketing activities](https://docs.kentico.com/13/on-line-marketing-features/managing-your-on-line-marketing-features/contact-management/tracking-contact-activities.md) that are logged in memory, and bulk inserts them to the database. | | ActivityProcessedInLogService | Execute | CMSEventArgs | Fires when an [on-line marketing activity](https://docs.kentico.com/13/on-line-marketing-features/managing-your-on-line-marketing-features/contact-management/tracking-contact-activities.md) is logged and processed. At this point, the activity is only stored in the application memory (activities are regularly processed and saved in bulk to the database – see the _ActivityBulkInsertPerformed_ event). | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## AutomationEvents **Namespace**: CMS.Automation Contains events related to [marketing automation](https://docs.kentico.com/13/on-line-marketing-features/managing-your-on-line-marketing-features/marketing-automation.md) actions. | Event | Event types | Handler parameters | Description | | ------------------ | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | MoveToNextStep | Before
After
Failure | AutomationEventArgs
**Properties**
InfoObject (BaseInfo)
StateObject (AutomationStateInfo)
PreviousStep (WorkflowStepInfo) | Occurs when a contact in an automation process moves to the next step. | | MoveToPreviousStep | Before
After
Failure | AutomationEventArgs
**Properties**
InfoObject (BaseInfo)
StateObject (AutomationStateInfo)
PreviousStep (WorkflowStepInfo) | Occurs when a contact in an automation process moves back to the previous step. | | Action | Before
After
Failure | WorkflowActionEventArgs
Requires references to:
CMS.WorkflowEngine
CMS.DataEngine | Occurs when the system executes a marketing automation action step. | | ProcessTrigger | Before
After
Failure | AutomationProcessTriggerEventArgs
**Properties**
Options (IEnumerable)
TriggerInfo (ObjectWorkflowTriggerInfo) | Occurs when processing triggers for automation processes. The system evaluates triggers periodically in bulk for a certain number of related contacts (represented by the collection in the _Options_ property of the _AutomationProcessTriggerEventArgs_ parameter).
Evaluates the trigger condition and allows you to, for example, insert data into the condition. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## SystemEvents **Namespace**: CMS.Base Contains general system events. | Event | Event types | Handler parameters | Description | | --------- | ----------- | --------------------------------------------------------------------------------- | ------------------------------------------------------- | | Exception | Execute | SystemEventArgs
**Properties**
Exception (Exception)
LogException (bool) | Fires when an unhandled exception occurs in the system. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## SiteEvents **Namespace**: CMS.SiteProvider Contains events related to site actions. | Event | Event types | Handler parameters | Description | | ------ | -------------------------- | --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | | Delete | Before
After
Failure | SiteDeletionEventArgs
**Properties**
User (UserInfo)
Context (CMSActionContext)
Info (DeletionInfo) | Occurs when a site is deleted from the system. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## SqlEvents **Namespace**: CMS.DataEngine Contains events related to the execution of queries and other database operations. | Event | Event types | Handler parameters | Description | | --------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | BulkInsert | Before
After
Failure | BulkInsertDataEventArgs
**Properties**
Connection (IDataConnection)
InsertSettings (BulkInsertSettings)
SourceData (DataTable)
TargetTable (string) | Occurs when the system creates objects by directly inserting data into a database table (for example when [importing contacts](https://docs.kentico.com/13/on-line-marketing-features/managing-your-on-line-marketing-features/contact-management/working-with-contacts/importing-contacts.md) from CSV files). | | ExecuteQuery | Before
After
Failure | ExecuteQueryEventArgs
**Properties**
Connection (IDataConnection)
Query (QueryParameters)
Result (DataSet) | Occurs when the system executes a database query.
**Note**: The _ExecuteQuery_ event does NOT trigger when the system (or custom code) enumerates through the results of an [ObjectQuery](https://docs.kentico.com/13/custom-development/retrieving-database-data-using-objectquery-api.md) call. The **ExecuteReader** event is triggered instead.
See also: [Working with database queries in the API](https://docs.kentico.com/13/custom-development/working-with-database-queries-in-the-api.md) | | ExecuteNonQuery | Before
After
Failure | ExecuteQueryEventArgs
**Properties**
Connection (IDataConnection)
Result (DataSet) | Occurs when the system executes a non-query database operation. | | ExecuteScalar | Before
After
Failure | ExecuteQueryEventArgs
**Properties**
Connection (IDataConnection)
Query (QueryParameters)
Result (DataSet) | Occurs when the system executes a scalar query. | | ExecuteReader | Before
After
Failure | ExecuteQueryEventArgs
**Properties**
Connection (IDataConnection)
Result (DataSet) | Occurs when the system runs a database [DataReader](https://docs.microsoft.com/en-us/dotnet/framework/data/adonet/dataadapters-and-datareaders).
**Note**: This event is triggered when the system (or custom code) materializes an [ObjectQuery](https://docs.kentico.com/13/custom-development/retrieving-database-data-using-objectquery-api.md) call, typically by enumerating through the results. However, this is not the case for [DocumentQuery](https://docs.kentico.com/13/custom-development/working-with-pages-in-the-api.md) calls, which trigger the **ExecuteQuery** event instead. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## Application events Xperience provides a set of events that you can use to customize the global behavior of the application. ### ApplicationEvents **Namespace**: CMS.Base Contains events related to the application life cycle. The following table lists the events that **occur once in the application's life cycle, in order of execution**: | Event | Event types | Handler parameters | Description | | -------------- | ----------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | PreInitialized | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs when the application finishes pre-initialization (preparation of things unrelated to the database).
Handlers need to be assigned in the **PreInit** method of [custom modules](https://docs.kentico.com/13/custom-development/creating-custom-modules/initializing-modules-to-run-custom-code.md). | | Initialized | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs when the application finishes initialization and starts (including all modules and the database connection). Handle this event to perform standard application start events. | | PostStart | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs at the end of the first application request. Allows you to perform asynchronous tasks needed for application startup.
Running long operations within this event's handlers can negatively affect the response time of the first request when starting the application. | | End | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs when the application ends. | The following events occur as needed during the application life cycle: | Event | Event types | Handler parameters | Description | | ------------ | ----------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | Error | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Fires when an error occurs in the application. | | SessionStart | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs when an HTTP session starts for a client. | | SessionEnd | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs when an HTTP session ends for a client. May not be raised if the application is configured to use a session state mode different than _InProc._ | ### RequestEvents **Namespace**: CMS.Base Contains events related to handling of requests. See also: [ASP.NET Application Life Cycle Overview](https://docs.microsoft.com/en-us/previous-versions/bb470252\(v=vs.140\)) The following table lists the request events **in order of execution**: | Event | Event types | Handler parameters | Description | | ----------------------- | ----------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Prepare | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs before the request processing begins. | | Begin | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs when the request processing starts. | | Authenticate | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs when authenticating requests. | | Authorize | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs when authorizing requests. | | PostAuthorize | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs after the request's user is authorized. | | PostResolveRequestCache | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs when ASP.NET bypasses execution of the current handler and allows a caching module to serve the request from the cache. | | MapRequestHandler | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs when a handler is selected to respond to the request. | | PostMapRequestHandler | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs after the application has mapped the request to the appropriate event handler. | | AcquireRequestState | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs when acquiring the state (for example session state) that is associated with the current request. | | PostAcquireRequestState | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs after the request state (for example session state) that is associated with the current request has been obtained. | | End | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs at the end of the request processing. | | PreSendRequestHeaders | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs just before ASP.NET sends HTTP headers to the client. | | RunEndRequestTasks | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Allows you to execute background tasks at the end of the request processing. Running long tasks in this event's handlers can negatively affect the response time of requests. | | Finalize | Execute | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | Occurs when the request is finalized. Use to cleanup and release any resources used by the request. Running long tasks in this event's handlers can negatively affect the response time of requests. | > **Tip:** **Handling other HttpApplication events** > > If you wish to handle **HttpApplication** events that are not available in the Xperience _RequestEvents_ class, you need to create and register a custom HTTP module. > > See [Walkthrough: Creating and Registering a Custom HTTP Module](https://docs.microsoft.com/en-us/previous-versions/aspnet/ms227673\(v=vs.100\)) for more information.