--- title: "Creating an Event-Based On-Demand Scan" slug: "creating-an-event-based-on-demand-scan" updated: 2026-09-08T19:10:56Z published: 2026-09-08T19:10:56Z canonical: "docs.trellix.com/creating-an-event-based-on-demand-scan" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Creating an Event-Based On-Demand Scan ###### To create an event-based malware scan for all host endpoints: ### Important Your on-demand malware scans are not saved to your Malware Scans policy until you click **Save**. 1. From the **Admin** menu, select **Policies** to access the **Policies** page. 2. In the Policies table, click the **Agent Default Policy** link to access the **Edit Policy** page. 3. Select the **Malware Scans** tab. 4. In the Malware Scans section, verify that the **Scheduled Scans** ON/OFF switch is turned **ON**. ![UI_Policy_MalScan_Enable.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-75f4bbe3-4b22-ad87-265a-2d6941799d22(1).png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A46%3A21Z&se=2026-11-22T13%3A46%3A21Z&sr=c&sp=r&sig=WGrrViZEx7DgzZpdZ7AUxWpsgFL2saZhRWINqi2CJyk%3D) 5. In the Malware Scans section, click **Create Scan** to access the **Create Scan** window. ![UI_Policy_MalScan_OD_Create.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-c622de31-5de5-ed4b-99f3-6405e2bb30c6(1).png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A46%3A21Z&se=2026-11-22T13%3A46%3A21Z&sr=c&sp=r&sig=WGrrViZEx7DgzZpdZ7AUxWpsgFL2saZhRWINqi2CJyk%3D) 6. In the **Scan Name** field, enter the name of your scheduled scan. Scan names are restricted to 70 alphanumeric characters or less and can include a combination of dashes, spaces, and underscores. 7. In the scan event drop-down, Select **Event** to create an event-based malware scan. 8. Select the event type. Valid options include: - **Signature update**: This is the default option. Signature update scans start when the agent receives malware signature updates. - **Boot**: Boot scans start when the host endpoint boots or reboots. - **Scan on USB Insert**: Scan on USB Insert automatically scans a USB drive when it is connected to the host. Select one of the following options: - **Full Scan:** to recursively scan all files in the root directory and its sub-folders. - **Quick Scan**: to non-recursively scan all files in the root directory excluding any files in the sub-folders. 9. In the **Scan will have the following depth** section, select the scan depth. Options include Full and Active Memory. 10. Click **Create** to create your on-demand malware scan. 11. Click **Save** to save your on-demand malware scan to the Malware Scans policy. ### Important To use the Scan on USB Insert option, you must use the Scan On Install toggle on the Malware Scans Policy page to enable the feature. **To create an event-based malware scan for select host sets:** ### Note [See Creating a Custom Policy](/docs/creating-a-custom-policy) for more information about using the Web UI to create a custom policy. 1. From the **Admin** menu, select **Policies** to access the **Policies** page. 2. In the Policies table, click the link for the custom policy you want to modify. 3. Select the **Malware Scans** tab. 4. In the Malware Scans section, verify that the **Scheduled Scans** ON/OFF switch is turned **ON**. ![UI_Policy_MalScan_Enable.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-75f4bbe3-4b22-ad87-265a-2d6941799d22(1).png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A46%3A21Z&se=2026-11-22T13%3A46%3A21Z&sr=c&sp=r&sig=WGrrViZEx7DgzZpdZ7AUxWpsgFL2saZhRWINqi2CJyk%3D) 5. In the Malware Scans section, click **Create Scan**to access the **Create Scan** window. ![UI_Policy_MalScan_OD_Create.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-c622de31-5de5-ed4b-99f3-6405e2bb30c6(1).png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A46%3A21Z&se=2026-11-22T13%3A46%3A21Z&sr=c&sp=r&sig=WGrrViZEx7DgzZpdZ7AUxWpsgFL2saZhRWINqi2CJyk%3D) 6. In the **Scan Name** field, enter the name of your scheduled scan. Scan names are restricted to 70 alphanumeric characters or less and can include a combination of dashes, spaces, and underscores. 7. In the scan event drop-down, Select **Event** to create an event-based malware scan. 8. Select the event type. Valid options include: - **Signature update**: This is the default option. Signature update scans start when the agent receives malware signature updates. - **Boot**: Boot scans start when the host endpoint boots or reboots. - **Scan on USB Insert**: Scan on USB Insert automatically scans a USB drive when it is connected to the host. You can use Full Scan to examine all files and folders on the drive. ### Important To use the Scan on USB Insert option, you must use the Scan On Install toggle on the Malware Scans Policy page to enable the feature. 9. In the **Scan will have the following depth** section, select the scan depth. Options include Full and Active Memory. 10. Click **Create** to create your on-demand malware scan. 11. Click **Save** to save your on-demand malware scan to the Malware Scans policy. ### Important Your on-demand malware scans are not saved to your Malware Scans policy until you click **Save**. Now you can assign host sets to the custom policy and set the policy priority level. See [Assigning Host Sets to Agent Policies](/docs/assigning-host-sets-to-xagent-policies) and [Configuring Policy Priority Using the Web UI](/docs/configuring-policy-priority-using-the-web-ui) for more information. :