--- title: "Uploading custom IPS rules from a file (Web UI)" slug: "uploading-custom-ips-rules-from-a-file-web-ui" tags: ["Network Security (NX)", "Product Usage"] updated: 2026-10-02T11:20:00Z published: 2026-10-02T11:20:00Z canonical: "docs.trellix.com/uploading-custom-ips-rules-from-a-file-web-ui" --- > ## 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. # Uploading custom IPS rules from a file (Web UI) You can upload multiple custom IPS rules to your IPS-enabled platform from a single ASCII text file or a .csv file. To upload custom IPS rules from a file, use the Custom Rules page. When you upload a file of custom IPS rules, the system adds the new rules to the appliance IPS rules database. The database stores both standard IPS rules (provided by Trellix) and any custom IPS rules that you create. In the following example of the IPS Custom Rules page, the appliance IPS rules database does not yet contain custom IPS rules. ![scap_ips_custom_rules_empty_click_upload.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-41ba2bb4-d655-862e-c180-e59244967c2c.png?sv=2026-02-06&spr=https&st=2026-11-20T05%3A19%3A41Z&se=2026-11-20T06%3A19%3A41Z&sr=c&sp=r&sig=BieC3MWtZvkeSvuOg6HWbg67xdPD2E3oxiiy6iZffIg%3D) ### Important If you add a custom IPS rule with a signature ID that is also used by a custom IPS rule already in the database, the new rule overwrites the existing rule. If an IPS policy that includes a new or changed rule is already active on a monitoring interface, the rule does not go into effect on that interface until you click and confirm **Apply Rules**. ### Note The file you upload does not need to include all custom rules that you want to retain in the rules database. In contrast, for software releases earlier than 7.7.0, you would delete custom IPS rules by uploading a rules file that did not include the rules you wanted to remove. ##### Prerequisites - An ASCII text file or a .csv file that contains custom IPS rules is accessible from the local desktop from which you access the Web UI of the IPS-enabled platform. For information about the format of a custom IPS rules file, see Syntax for custom IPS rules. - Log in to the Web UI as Operator or Admin. ##### Procedure To upload custom IPS rules from an ASCII or a .csv file to the IPS rules database on your appliance: 1. Choose **IPS > Custom Rules**. The page lists the custom IPS rules in the appliance IPS rules database. 2. Click **Browse**. ![scap_ips_custom_rules_upload_file_selection.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-92db44de-416b-10c7-13b0-c4a7dff10cd1.png?sv=2026-02-06&spr=https&st=2026-11-20T05%3A19%3A41Z&se=2026-11-20T06%3A19%3A41Z&sr=c&sp=r&sig=BieC3MWtZvkeSvuOg6HWbg67xdPD2E3oxiiy6iZffIg%3D) 3. Select the custom IPS rules file you want to import. 4. Click **Choose File** and navigate to the CSV file you want to upload. Click **Upload** to upload the custom IPS rules. 5. Check the rule syntax. - The system checks the syntax of the rules in the file and then saves the validated rules to its database of IPS rules. The following message appears: ![scap_ips_custom_rules_msg_upload_succeeded.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-ef0df176-2ae1-9ca5-c85c-08e49a302552.png?sv=2026-02-06&spr=https&st=2026-11-20T05%3A19%3A41Z&se=2026-11-20T06%3A19%3A41Z&sr=c&sp=r&sig=BieC3MWtZvkeSvuOg6HWbg67xdPD2E3oxiiy6iZffIg%3D) If a rule in the file contains syntax errors, it is not saved to the database of IPS rules. A warning message appears below the rule: ![scap_ips_custom_rules_msg_syntax_error.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-dd391750-9d7c-35bb-283d-cd725c504f14.png?sv=2026-02-06&spr=https&st=2026-11-20T05%3A19%3A41Z&se=2026-11-20T06%3A19%3A41Z&sr=c&sp=r&sig=BieC3MWtZvkeSvuOg6HWbg67xdPD2E3oxiiy6iZffIg%3D) To edit the rule, click the edit (blue pencil) icon, fix the error, and then click **Save**. For syntax information, see Syntax for Custom IPS Rules. - If the custom IPS rules file is empty, the following message appears: ![scap_ips_custom_rules_msg_upload_failed.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-13fc9a3d-3b52-1699-9641-7b8f182b062e.png?sv=2026-02-06&spr=https&st=2026-11-20T05%3A19%3A41Z&se=2026-11-20T06%3A19%3A41Z&sr=c&sp=r&sig=BieC3MWtZvkeSvuOg6HWbg67xdPD2E3oxiiy6iZffIg%3D) 6. Close the green message bar. 7. When you are ready to apply the updated list of custom IPS rules, click **Apply Rules**. ![scap_ips_custom_rules_button_Apply_Rules.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-90e97e78-f6fe-04d7-f1e7-45f8f9df454b.png?sv=2026-02-06&spr=https&st=2026-11-20T05%3A19%3A41Z&se=2026-11-20T06%3A19%3A41Z&sr=c&sp=r&sig=BieC3MWtZvkeSvuOg6HWbg67xdPD2E3oxiiy6iZffIg%3D) ### Note Trellix recommends that you click **Apply Rules** immediately after the rules have been saved to the database. 8. Click **OK**. The IPS-enabled rules engine re-evaluates active IPS policies against the updated database of IPS rules. The following message appears: ![scap_ips_custom_rules_msg_apply_succeeded.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-8cc24414-bc3e-661d-4a08-336172d8d7fe.png?sv=2026-02-06&spr=https&st=2026-11-20T05%3A19%3A41Z&se=2026-11-20T06%3A19%3A41Z&sr=c&sp=r&sig=BieC3MWtZvkeSvuOg6HWbg67xdPD2E3oxiiy6iZffIg%3D) 9. Close the green message bar. :