--- 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/k10/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/k10/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 (requires [hotfix 10.0.43](https://devnet.kentico.com/download/hotfixes) or newer).
Note: This event is not available among the events of specific object types: _Info.TYPEINFO.Events_. To add a handler for a specific object type, assign the handler to the global _ObjectEvents.BulkInsert_ event, and add an object type condition into the handler code using the _TypeInfo_ property of the _BulkInsertEventArgs_ parameter. For example: _if (e.TypeInfo.ObjectType == UserInfo.OBJECT\_TYPE)_ | | 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.
Note: This event is not available among the events of specific object types: _Info.TYPEINFO.Events_. To add a handler for a specific object type, assign the handler to the global _ObjectEvents.BulkUpdate_ event, and add an object type condition into the handler code using the _TypeInfo_ property of the _BulkUpdateEventArgs_ parameter. For example: _if (e.TypeInfo.ObjectType == UserInfo.OBJECT\_TYPE)_ | | BulkDelete | Before
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.
Note: This event is not available among the events of specific object types: _Info.TYPEINFO.Events_. To add a handler for a specific object type, assign the handler to the global _ObjectEvents.BulkDelete_ event, and add an object type condition into the handler code using the _TypeInfo_ property of the _BulkDeleteEventArgs_ parameter. For example: _if (e.TypeInfo.ObjectType == UserInfo.OBJECT\_TYPE)_ | | 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/k10/configuring-kentico/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/k10/custom-development/miscellaneous-custom-development-tasks/smart-search-api-and-customization/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/k10/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/k10/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.
Note: This event is not available among the events of specific object types: _Info.TYPEINFO.Events_. To add a handler for a specific object type, assign the handler to the global _ObjectEvents.Sort_ event, and add an object type condition into the handler code using the _Object_ property of the _ObjectSortEventArgs_ parameter. For example: _if (e.Object.TypeInfo.ObjectType == UserInfo.OBJECT\_TYPE)_ | | 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.
Note: This event is not available among the events of specific object types: _Info.TYPEINFO.Events_. To add a handler for a specific object type, assign the handler to the global _ObjectEvents.ChangeOrder_ event, and add an object type condition into the handler code using the _Object_ property of the _ObjectChangeOrderEventArgs_ parameter. For example: _if (e.Object.TypeInfo.ObjectType == UserInfo.OBJECT\_TYPE)_ | | 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 Kentico in the **Data** property.
The **Total** **Records** 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/k10/managing-website-content/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/k10/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. | | 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 Smart 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/k10/custom-development/miscellaneous-custom-development-tasks/smart-search-api-and-customization/customizing-the-content-of-search-indexes.md) | | 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/k10/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/k10/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 Kentico in the **Data** property.
The **Total** **Records** property provides a number of total records in case paging is used. Use _-1_ to use rows count of the **Data** property. | | 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/k10/managing-website-content/configuring-the-environment-for-content-editors/configuring-workflows.md) and [versioning](https://docs.kentico.com/k10/managing-website-content/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/k10/managing-website-content/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. | Event | Event types | Handler parameters | Description | | ----------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Authenticate | Execute | AuthenticationEventArgs
**Properties**
User (UserInfo)
UserName (string)
Password (string) | Occurs when authenticating users.
**See also**: [Handling custom external authentication](https://docs.kentico.com/k10/custom-development/handling-global-events/handling-custom-external-authentication.md) | | AuthenticationRequested | Execute | AuthenticationRequestEventArgs
**Properties**
RequestedUrl (string) | Occurs when a user accesses a restricted section of Kentico and the user's authentication is required. | | MultiFactorAuthenticate | Execute | AuthenticationEventArgs
**Properties**
Passcode (string)
UserName (string)
Password (string) | Occurs when a user tries to sign in to Kentico with [multi-factor authentication](https://docs.kentico.com/k10/managing-users/user-registration-and-authentication/configuring-multi-factor-authentication.md) enabled. | | AuthorizeResource | Execute | AuthorizationEventArgs
**Properties**
User (UserInfo)
ResourceName (string)
PermissionName (string)
Authorized (bool) | Occurs when checking the 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 a website. | [> 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/k10/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/k10/custom-development/handling-global-events/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/k10/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/k10/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/k10/custom-development/handling-global-events/excluding-content-from-staging-and-integration.md)
[Automatically synchronizing staging and integration tasks](https://docs.kentico.com/k10/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 Kentico and other applications using the [integration bus](https://docs.kentico.com/k10/integrating-3rd-party-systems/using-the-integration-bus.md). See also: - [Excluding content from staging and integration](https://docs.kentico.com/k10/custom-development/handling-global-events/excluding-content-from-staging-and-integration.md) - [Automatically synchronizing staging and integration tasks](https://docs.kentico.com/k10/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/k10/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/k10/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 Kentico (via [import/export](https://docs.kentico.com/k10/deploying-websites/exporting-and-importing-sites.md) or [staging](https://docs.kentico.com/k10/deploying-websites/content-staging.md)), the IDs of objects can differ between the environments. Kentico 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/k10/developing-websites/defining-website-content-structure/custom-tables.md) or [page type](https://docs.kentico.com/k10/developing-websites/defining-website-content-structure/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/k10/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) ## BizFormItemEvents **Namespace**: CMS.OnlineForms Contains events related to [form](https://docs.kentico.com/k10/managing-website-content/forms.md) actions. See [Working with form data using the API](https://docs.kentico.com/k10/custom-development/miscellaneous-custom-development-tasks/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/k10/custom-development/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/k10/e-commerce-features/managing-your-store/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. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## NewsletterEvents **Namespace**: CMS.Newsletters Contains events related to [Email marketing](https://docs.kentico.com/k10/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 a campaign email 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 | | ----------------------- | --------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | LogConversion | Before
After
Failure | CMSEventArgs | Occurs when a custom conversion is logged. You can access the data of the custom conversion via the _Parameter_ property of the _CMSEventArgs_ parameter. | | ProcessLogRecord | Before
After
Failure | CMSEventArgs | Occurs when the web analytics log is processed. | | ProcessAnalyticsService | Before
After
Failure  | AnalyticsJSEventArgs
**Properties**
QueryParameters (Dictionary) | Occurs when the system logs any web analytics. | | InsertAnalyticsJS | Before
After
Failure  | AnalyticsJSEventArgs
**Properties**
QueryParameters (Dictionary) | Occurs when the web analytics JavaScript snippet is inserted into the page. | | 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/k10/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/k10/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/k10/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 an automation process moves to the next step. | | MoveToPreviousStep | Before
After
Failure | AutomationEventArgs
**Properties**
InfoObject (BaseInfo)
StateObject (AutomationStateInfo)
PreviousStep (WorkflowStepInfo) | Occurs when 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) ## OutputFilterEvents **Namespace**: CMS.OutputFilter Contains events related to [output filters](https://docs.kentico.com/k10/configuring-kentico/using-output-filters.md). | Event | Event types | Handler parameters | Description | | ------------------------------- | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | SaveOutputToCache | Before
After
Failure | OutputCacheEventArgs
**Properties**
Output (CachedOutput)
ViewMode (ViewModeOnDemand)
FallbackToRegularLoad (bool) | Fires when an output filter saves the output to the cache. | | SendCacheOutput | Before
After
Failure | OutputCacheEventArgs
**Properties**
Output (CachedOutput)
ViewMode (ViewModeOnDemand)
FallbackToRegularLoad (bool) | Fires before content from the [output cache](https://docs.kentico.com/k10/configuring-kentico/optimizing-website-performance/configuring-caching/caching-page-output.md) is sent as a response. Occurs only if the cached output is found, and if the cached output gives an opportunity to the user to change the output or to bypass caching entirely. | | CurrentFilter.OnBeforeFiltering | filter (ResponseOutputFilter)
finalHtml (ref string) | Fires before output filtering occurs. See [Making custom modifications to output HTML](https://docs.kentico.com/k10/custom-development/handling-global-events/making-custom-modifications-to-output-html.md). | | | CurrentFilter.OnAfterFiltering | filter (ResponseOutputFilter)
finalHtml (ref string) | Fires after output filtering occurs. See [Making custom modifications to output HTML](https://docs.kentico.com/k10/custom-development/handling-global-events/making-custom-modifications-to-output-html.md) . | | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## URLRewritingEvents **Namespace**: CMS.URLRewritingEngine Contains events related to [URL rewriting](https://docs.kentico.com/k10/configuring-kentico/configuring-page-urls.md) and page redirection. | Event | Event types | Handler parameters | Description | | ---------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | PageNotFound | Execute | URLRewriterPageNotFoundEventArgs
**Properties**
PageNotFoundHandled (bool)
RelativePath (string)
SiteName (SiteNameOnDemand)
ViewMode (ViewModeOnDemand) | Occurs when the system redirects users to a [Page not found error page](https://docs.kentico.com/k10/securing-websites/developing-secure-websites/handling-error-messages-securely/creating-custom-error-handling-pages.md) (after requesting a URL that returns a 404 HTTP status code). | | ProcessRewritingResult | Before
After
Failure |  URLRewritingEventArgs
**Properties**
Parameters (URLRewritingParams) | Occurs at the end of the rewriting process for all URLs. If there are redirects during the rewriting, the event is only triggered for the final URL at the end of the process.
Use the **Before** event if you need to perform custom rewriting. To avoid the default rewriting steps, set the _URLRewritingEventArgs.Parameters.Status_ property to _RequestStatusEnum.PathRewritten_.
Use the **After** event to perform additional custom actions after the default rewriting. | | ProcessABTest | Execute | ProcessABTestEventArgs
**Properties**
PageInfo (PageInfo)
ReturnedPageInfo (PageInfo)
SiteName (String)
ViewMode (ViewModeEnum) | Occurs when the system starts rewriting the URL of a page with a running [A/B test](https://docs.kentico.com/k10/on-line-marketing-features/managing-your-on-line-marketing-features/optimization-testing/a-b-testing-website-pages.md). | [> 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) | **\[Only available after applying [hotfix 10.0.43](https://devnet.kentico.com/download/hotfixes)** **or newer]**
Occurs when the system creates objects by directly inserting data into a database table (for example when [importing contacts](https://docs.kentico.com/k10/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.
See also: [Working with database queries in the API](https://docs.kentico.com/k10/custom-development/miscellaneous-custom-development-tasks/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. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## Application events Kentico 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/k10/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._ | | GetVaryByCustomString | Execute | GetVaryByCustomStringEventArgs
**Properties**
Result (string)
Context (HttpContext)
Custom (string) | Occurs when the application processes variables in custom names of [output cache](https://docs.kentico.com/k10/configuring-kentico/optimizing-website-performance/configuring-caching/caching-page-output.md) keys. | ### RequestEvents **Namespace**: CMS.Base Contains events related to handling of requests. See also: [ASP.NET Application Life Cycle Overview](http://msdn.microsoft.com/en-us/library/bb470252.aspx) 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. If the application loads the response from the [output cache](https://docs.kentico.com/k10/configuring-kentico/optimizing-website-performance/configuring-caching/caching-page-output.md), the life cycle skips to the **End** event. | | 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. Not used by the Kentico [output caching](https://docs.kentico.com/k10/configuring-kentico/optimizing-website-performance/configuring-caching/caching-page-output.md) (see the _Authorize_ event).
The system performs [URL rewriting](https://docs.kentico.com/k10/configuring-kentico/configuring-page-urls.md) during the event. After this event, the application can access the context of the displayed page and current page (page info). | | 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. | | 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 Kentico _RequestEvents_ class, you need to create and register a custom HTTP module. You can implement the module in the _App\_Code_ folder of web site projects or as part of a custom assembly. > > See [Walkthrough: Creating and Registering a Custom HTTP Module](http://msdn.microsoft.com/en-us/library/ms227673%28v=vs.100%29.aspx) for more information. ### SessionEvents **Namespace**: CMS.Membership Contains events related to session management. | Event | Event types | Handler parameters | Description | | ----------------- | -------------------------- | --------------------------------------------------------- | --------------------------------------------------- | | UpdateSession | Before
After
Failure | CMSEventArgs | Occurs when an HTTP session is updated. | | UpdateSessionData | Execute | CMSEventArgs
**Properties**
Parameter (SessionInfo) | Occurs when the data of an HTTP session is updated. | [> Back to list of event categories](#referenceglobalsystemevents-eventstop) ## Control and page events You can handle events related to the life cycle of pages and controls. The events are defined directly in the base classes of system pages and controls. You can leverage the events to customize the user interface. The events are direct delegates. ### AbstractUserControl **Namespace**: CMS.Base.Web.UI Contains events that occur during the user control life cycle. | Event | Handler parameter | Handler return type | | ---------------------------- | ------------------------------------------------------------------------------------------- | ------------------- | | OnBeforeUserControlInit | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | bool | | OnAfterUserControlInit | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | void | | OnBeforeUserControlLoad | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | bool | | OnAfterUserControlLoad | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | void | | OnBeforeUserControlPreRender | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | bool | | OnAfterUserControlPreRender | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | void | | OnBeforeUserControlRender | [HtmlTextWriter](http://msdn.microsoft.com/en-us/library/system.web.ui.htmltextwriter.aspx) | bool | | OnAfterUserControlRender | [HtmlTextWriter](http://msdn.microsoft.com/en-us/library/system.web.ui.htmltextwriter.aspx) | void | > **Info:** Return _true_ in Before handlers to perform the default system actions for the given event. ### CMSPage **Namespace**: CMS.UIControls Contains events that occur during the system page life cycle. | Event | Handler parameter | Handler return type | | --------------------- | ------------------------------------------------------------------------------------------- | ------------------- | | OnBeforePagePreInit | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | bool | | OnAfterPagePreInit | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | void | | OnBeforePageInit | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | bool | | OnAfterPageInit | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | void | | OnBeforePageLoad | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | bool | | OnAfterPageLoad | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | void | | OnBeforePagePreRender | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | bool | | OnAfterPagePreRender | [EventArgs](http://msdn.microsoft.com/en-us/library/system.eventargs.aspx) | void | | OnBeforePageRender | [HtmlTextWriter](http://msdn.microsoft.com/en-us/library/system.web.ui.htmltextwriter.aspx) | bool | | OnAfterPageRender | [HtmlTextWriter](http://msdn.microsoft.com/en-us/library/system.web.ui.htmltextwriter.aspx) | void | > **Info:** Return _true_ in Before handlers to perform the default system actions for the given event. [> Back to list of event categories](#referenceglobalsystemevents-eventstop)