Add styles to a project

Styles are containers that store symbols, colors, color schemes, label placements, and layout items. They promote consistency and standardization across maps, scenes, and layouts. The symbol galleries and color pickers you work with when you author maps, scenes, and layouts are populated by items stored in styles.

Project styles

Styles are managed as items in a project. You can add as many styles as you want to a project.

Add styles to a project

There are different types of styles you can add, as outlined in the following table. See the Styles topic for details about each type.

Type of styleDescription

System style Style file (*.stylx)

The styles that are authored by Esri and included in the ArcGIS Pro installation. Some system styles are added to new projects by default, but you can add any of the other system styles to a project also.

Custom style Style file (*.stylx)

Any style that is not a system style is a custom style. You can add custom styles to a project or you can create styles.

Web style Web Style

Web styles are used in the Scene Viewer. They support fewer style item types and symbol properties than ArcGIS Pro styles.

Mobile style Mobile style

Mobile styles are used in mobile apps. They support fewer style item properties than ArcGIS Pro styles.

To add a style to a project, follow these steps:

  1. On the Insert tab, in the Styles group, click Add Add Style.
    • To add a custom style (including a web style or a mobile style), click Add Style Add Style. In the Add a style file dialog box, browse to the location of the style, either locally or on a portal.
    • To add a system style, click Add System Style Add System Style to open the System Styles dialog box. System styles are grouped by theme in the list on the left. Expand the groups and check one or more styles to add.
  2. Click OK to add the style to the project.

Alternatively, you can add styles from the Catalog pane or a catalog view. Right-click the Styles folder and click Add Add Style.

To remove a style from a project, locate it under the Styles folder in the Catalog pane or a catalog view. Right-click and click Remove Remove.

Add styles from ArcGIS Online and ArcGIS Enterprise

You can browse to or search for styles or web styles on ArcGIS Online and ArcGIS Enterprise. These may be styles created by Esri for specific industries in specific languages or styles created by you, your organization, or someone else.

ArcGIS Pro styles added to a project from ArcGIS Online or ArcGIS Enterprise become a project item in the current project but are stored in your user profile at [drive]:\Users\[your_name]\Documents\ArcGIS\OnlineStyles. You can add them to other projects from that local location without importing them again. When you add web styles to a project, a reference is maintained to their online location. They are not copied locally.

To add a style to a project from ArcGIS Online and ArcGIS Enterprise, follow these steps:

  1. On the Insert tab, in the Styles group, click Add Add Style.
  2. In the Add a style file dialog box, click the Portal heading Online or one of the subheadings underneath it. If necessary, type a search term into the field at the top of the pane. Search for stylx to find all available style files.
  3. Highlight the style and click OK.

Create a style in the project

You can create empty styles in a project. Manage the style from a catalog view to copy style items from other project styles into it or create style items directly. When you create a style, you choose a file location to store it. You can then access that style from that location from other projects.

To create a style in a project, follow these steps:

  1. On the Insert tab, in the Styles group, click New Style New Style.

    Alternatively, click New Mobile Style New Mobile Style to create a mobile style suited for use with maps that will be shared in mobile apps.

  2. Browse to a folder to store the new style. Type a name for the new style and click Save.

Import a desktop style into the project

Desktop styles (those used in ArcMap, ArcGlobe, or ArcScene) cannot be used directly in ArcGIS Pro because of differences in the underlying database structure. However, you can import a desktop style, which makes an ArcGIS Pro version of it and adds it to your project.

Once imported, the ArcGIS Pro version of the style is placed in the project home folder, for example, [install drive]:\\Users\MyUserName\Documents\ArcGIS\Projects\MyProjectName. You can reference it from this location (or copy it elsewhere) from other ArcGIS Pro projects. There is no need to import a desktop style more than once.

Caution:

Ensure that any fonts associated with the style are installed in the Fonts directory on your computer before importing.

To import a desktop style, follow these steps:

  1. On the Insert tab, in the Styles group, click Import Import Style File.
  2. Browse to a desktop style Style file (*.style file) and click OK to create a *.stylx file and add it to the project.

Upgrade a style

Styles created in older versions of ArcGIS Pro may reference an older symbol model and may have limited compatibility with the current version of ArcGIS Pro. When you add an out-of-date style, you are notified and given an option to upgrade the style. If you do not upgrade the style, it can still be used in a project, but it will be read-only. If you choose to upgrade it, a copy of it is made in the same location as the original style and the new editable version is added to the project.

To upgrade an out-of-date style in a project, right-click the style in the Catalog pane or a catalog view and click Upgrade Upgrade. An updated editable copy of the style is created in the same location as the original style and is added to the project.

Unsupported styles

If the status indicates that a style is not supported, it is because the style was created in or upgraded by a newer version of ArcGIS Pro or the style is corrupt. The error, The version of the selected style is not supported, or the style is otherwise invalid may be returned. Check the path where the style is located; a copy of the style for the correct version may have been previously generated.

Related topics