Upgrade custom themes and CSS to SharePoint 2013
Learn about upgrade issues with themes customizations, such as custom CSS and custom master pages, and how to update customizations to work in SharePoint 2013.
Last modified: June 17, 2013
Applies to: Office 365 | SharePoint Foundation 2013 | SharePoint Server 2013
The theming experience in SharePoint 2013 was redesigned to simplify the process of customizing sites by changing the site layout, color palette, font scheme, and background image. The themes user interface was redesigned and there is a set of new file formats related to themes. Custom themes that were created in SharePoint 2010 cannot be used on SharePoint 2013 sites, you must re-create them. Custom CSS files may not work successfully on SharePoint 2013 sites until after they are updated to work with the new master pages, color slots, and other theming changes.
This article describes the issues that may occur when you try to use custom SharePoint 2010 themes, SharePoint 2010 CSS, and custom CSS with the new theming experience. It also explains the changes you have to make to your custom SharePoint 2010 themes, SharePoint 2010 CSS, and custom CSS if you want to use them in SharePoint 2013 sites.
SharePoint 2010 themes can be used on site collections that are running in 2010 mode. For more information about site collection modes, see Plan for site collection upgrades in SharePoint 2013 or Plan to upgrade your SharePoint Online environment to the 2013 experience.
For more information about themes, see Themes overview for SharePoint 2013.
In SharePoint 2010, themes were stored in THMX files. In SharePoint 2013, there is a set of new file formats related to themes. Color palettes and font schemes are stored in separate XML files (.spcolor and .spfont files, respectively).
You cannot upgrade a THMX file from SharePoint 2010 to SharePoint 2013. If you applied a custom theme to your SharePoint 2010 site, when you upgrade to SharePoint 2013, the theme files remain in place, but the theme is no longer applied to the site, and the site reverts to the default theme. If you want to use your SharePoint 2010 themes customizations on SharePoint 2013 sites, you must re-create them using the SharePoint 2013 theming guidance.
For more information about creating themes customizations, see How to: Deploy a custom theme in SharePoint 2013 and Color palettes and fonts in SharePoint 2013. You can also use the SharePoint color palette tool to help you create SharePoint designs. You can download the SharePoint color palette tool from the Microsoft Download Center.
You can open a THMX file in PowerPoint to see how the colors are defined in the custom theme and then use the color palette tool to re-create the colors as a color palette file (an .spcolor file). A color palette is the combination of colors that are used in a SharePoint site.
You can also decide to use one of the preinstalled SharePoint 2013 themes. For more information, see Choose a theme for your publishing site on Office.com.
When you upgrade a SharePoint 2010 site to SharePoint 2013, the site is configured to use the default master page for SharePoint 2013. If you had a custom master page for your SharePoint 2010 site, it still resides in the site and you can apply it to the SharePoint 2013 site. You can use the SharePoint user interface or the SPWeb class to apply the custom master page to the upgraded site. For more information about how to change the master page, see How to: Apply a master page to a site in SharePoint 2013.
Consider the following before you decide whether to apply the SharePoint 2010 custom master page to the upgraded SharePoint 2013 site:
If the custom master page depends on custom CSS files: Applying the custom master page to the upgraded site should return the site to its original 2010 experience. But, you will be unable to apply a SharePoint 2013 theme to the site.
If you want to use the custom master page and custom CSS files together with the SharePoint 2013 theming experience, you must update the CSS files to use the new SharePoint 2013 color slots. If you want to access the custom master page from the themes user interface, you also have to create a master page preview file. For more information, see How to: Create a master page preview file in SharePoint 2013.
If the custom master page depends on SharePoint 2010 CSS files: CSS files have changed significantly from SharePoint 2010 to SharePoint 2013. In many cases, you will have to rework the master page so that it can work with new classes before you can successfully apply it to the upgraded site. For more information about CSS classes, see the Using the host web CSS in apps for SharePoint section in Apps for SharePoint UX design guidelines.
Unmodified SharePoint 2010 CSS files and custom CSS files cannot be used on SharePoint 2013 sites. The following describes SharePoint 2013 changes that apply to SharePoint 2010 CSS and custom CSS files:
Color slots. The number of available color slots has increased significantly in SharePoint 2013. You must update the color slots in SharePoint 2010 CSS files before they can be used in the new theming experience. For more information, see the Color slot mapping section in Color palettes and fonts in SharePoint 2013.
Font slots. You should review the list of available font slots and verify that the CSS files you want to use in SharePoint 2013 are using the correct font slots. For more information, see the Font slots section in Color palettes and fonts in SharePoint 2013.
New annotation. SharePoint 2013 has a new annotation that lets you replace the background image. For more information, see How to: Make custom CSS files themable in SharePoint 2013.
New classes. You may have to update CSS files to work with the new classes in SharePoint 2013. For more information about CSS classes (also referred to as CSS styles), see the Using the host web CSS in apps for SharePoint section in Apps for SharePoint UX design guidelines.