Customizing web parts

There are two basic ways to change or extend the functionality of existing web parts:

  • Customize the web part code – edit the markup or code behind of the user control that implements the web part.
  • Use macro expressions in web part properties – by inserting macro expressions into the values of web part properties, you can implement many types of custom functionality without modifying the web part code.

Important: We do not recommend customizing the code of the default web parts directly. Instead, create a clone of the required web part and implement the changes there. Using clones ensures that the system does not overwrite your code when applying hotfixes or upgrades to newer versions of Xperience.

Alternatively, you can create Inherited web parts – copies of existing web parts that share the code files, but allow you to modify the definitions of properties and their default values.