[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]ASP.NET WebForms Controls
 [Collapse]ASP.NET MVC Extensions
  [Expand]Product Information
  [Expand]Getting Started
  [Collapse]Common Concepts
    Web Application Project Templates
    Insert Extension Wizard
    Data Binding
   [Collapse]Applying Themes
     Applying Themes - The DevExpress Approach
     Applying Themes - The ASP.NET Approach
     Attaching a Custom Theme Assembly
    Client-Side API
    Declaring Server-Side Event Handlers
    Using Callbacks
    Passing Values to a Controller Action through Callbacks
    Supported Attributes for Model Validation
    Using Extensions in Razor Views
  [Expand]Grid View
  [Expand]Tree List
  [Expand]Card View
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Site Navigation and Layout
  [Expand]HTML Editor
  [Expand]Vertical Grid
  [Expand]Data Editors Extensions
  [Expand]Docking and Popups
  [Expand]File Management
  [Expand]Data and Image Navigation
  [Expand]Multi-Use Site Extensions
  [Expand]Query Builder
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Attaching a Custom Theme Assembly

If you create a custom theme assembly using the ASPxThemeBuilder tool and wish to apply a theme from this custom assembly, you should reference the theme assembly within your project.

  • Right click your site's References folder in Solution Explorer and click Add Reference...

  • Click the Browse... button and select the required theme assembly.

    This adds the assembly to the project's References folder. Remember to set this assembly's Copy Local property value to true in order to copy this assembly to the web server while deploying.

  • Assign the assembly name to the customThemeAssemblies option in the devExpress web.config section.

You can now apply the custom theme to your project.


A custom theme assembly should have the same minor/major version as other DevExpress assemblies used in a project. Otherwise, you should upgrade the theme assembly's source code, rebuild it, upgrade the corresponding references in the target MVC application. See the KA18887 KB Article for more information.

Expanded See Also

Is this topic helpful?​​​​​​​