--- schema_version: "1" id: 50b44c04d65a9cd03f99cd16c4074233c510f637be5c5cdd61a626b9dacf79c2 title: Creating a Custom Product Configuration Message collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/ind/264-0-0/comms_creating_a_custom_product_configuration_message.md canonical_url: https://help.salesforce.com/s/articleView?id=ind.comms_creating_a_custom_product_configuration_message.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 3a0a77c15dd3c7ad0815279159e211a08830c5e7f656d0527b8464f411d22c1a description: Product compatibility rules, also known as product configuration rules, determine if a product combination is valid. Salesforce includes default product configuration error messages in the Opportunity Manager, Order Manager, Quote Manager, and cart. However, you can create custom messages to provide more useful information to the user. products: - Communications - Media - Energy and Utilities release: "264" --- # Creating a Custom Product Configuration Message Product compatibility rules, also known as product configuration rules, determine if a product combination is valid. Salesforce includes default product configuration error messages in the Opportunity Manager, Order Manager, Quote Manager, and cart. However, you can create custom messages to provide more useful information to the user. For example, consider these sample error messages: - Product X requires Product Y - Product X excludes Product Y - Product X recommends Product Y You can create a custom message for each product relationship record. First, you create a user custom message field to display instead of the standard message. Then, you set the CustomRuleMessageFieldName custom setting. ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-comms_media_energy_managed-264-0-0-production-enus/ff4079f6-a384-475c-b863-578bbbb0ef9b/images/icon_note.png) Note Requires, excludes, and recommends rules support custom messages because they stay in the cart until the user acts on them. In contrast, auto-add and auto-remove rules don't need user interaction and only show as toast messages, so they don't support custom messages. To create a custom product configuration message: 1. Create a user custom message field. - From Setup, in the **Quick Find** box, enter Objects. - Click **Objects**. - Click **Product Relationship**. - In the **Custom Fields & Relationships** section, click **New**. - Create a new custom field with a **Data Type** of **Text Area**. Remember the API name for the field. For more information, see [Create Custom Fields](https://help.salesforce.com/s/articleView?id=sf.adding_fields.htm&type=0&language=en_US&release=206.10) in the Salesforce Help. ![The Custom Field Definition Detail section.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-comms_media_energy_managed-264-0-0-production-enus/ff4079f6-a384-475c-b863-578bbbb0ef9b/resources-product/images/salesforce_productrelationshipcustomfield_message.jpg) 2. Configure the custom field. - On the Vlocity CMT Administration tab, click **CPQ Configuration Setup**. - Scroll to **CustomRuleMessageFieldName**. - Click the **Action** button. ![Action icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-comms_media_energy_managed-264-0-0-production-enus/ff4079f6-a384-475c-b863-578bbbb0ef9b/resources-product/images/salesforce_cmtadmin_actionicon.jpg) - Enter the API name from the field you created in step 1, for example, Message\_\_c. - Click **Save**. ![The CustomRuleMessageFieldName setting.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-comms_media_energy_managed-264-0-0-production-enus/ff4079f6-a384-475c-b863-578bbbb0ef9b/resources-product/images/salesforce_cmtadmin_cpqconfig_custommessage.jpg) 3. Expose the new field on the Product Relationships record detail page. - On the Product Relationship tab, click a product relationship. - Click **Edit Layout**. ![The Edit Layout button on the Product Relationship page.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-comms_media_energy_managed-264-0-0-production-enus/ff4079f6-a384-475c-b863-578bbbb0ef9b/resources-product/images/salesforce_productrelationship_editlayout.jpg) - In the palette, select **Fields**. ![The Message field in the Layout palette.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-comms_media_energy_managed-264-0-0-production-enus/ff4079f6-a384-475c-b863-578bbbb0ef9b/resources-product/images/salesforce_pagelayoutedit_palette_message.jpg) - Drag the field you created in step 1 to the **Product Relationships Detail Information** section. ![The Product Detail Relationship section of the layout.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-comms_media_energy_managed-264-0-0-production-enus/ff4079f6-a384-475c-b863-578bbbb0ef9b/resources-product/images/salesforce_pagelayout_edit_productrelationshipdetail.jpg) - Click **Save**. 4. Enter the custom message. - On the Product Relationship tab, click a product relationship. - In the custom field, for example, **Message**, enter the custom message. ![The custom message in the Message field.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-comms_media_energy_managed-264-0-0-production-enus/ff4079f6-a384-475c-b863-578bbbb0ef9b/resources-product/images/salesforce_productrelationship_custommessage.jpg) 5. Ensure that the active implementation for the ProductValidationInterface is a validation rule implementation. - On the Interface Implementations tab, from the **View** picklist, select **All**. - Click **Go!**. - Click **ProductValidationInterface**. - Ensure that ValidationRulesImplementation or a custom implementation that invokes compatibility rules is active. If it is not, click the appropriate implementation and select **Active**. ![The ProductValidationInterface with ValidationRulesImplementation set to Active.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-comms_media_energy_managed-264-0-0-production-enus/ff4079f6-a384-475c-b863-578bbbb0ef9b/resources-product/images/salesforce_interfaceimplementation_productvalidationinterface_rulesimpl.jpg)