Create categorized renderer from styles

Sets a vector layer’s renderer to a categorized renderer using matching symbols from a style database. If no style file is specified, symbols from the user’s current symbol library are used instead.

A specified expression or field is used to create categories for the renderer. Each category is individually matched to the symbols which exist within the specified QGIS XML style database. Whenever a matching symbol name is found, the category’s symbol will be set to this matched symbol.

If desired, outputs can also be tables containing lists of the categories which could not be matched to symbols, and symbols which were not matched to categories.


Input layer [vector: any]
Vector layer to apply a categorized style to.
Categorize using expression [expression]
Field or expression to categorize the features.
Style database (leave blank to use saved symbols) [file]
File (.XML) containing the symbols to apply to the input layer categories. The file can be obtained from the Style Manager Share symbols tool. If no file is specified, QGIS local symbols library is used.
Use case-sensitive match to symbol names [boolean]

If checked, applies a case sensitive comparison between the categories and symbols names.

Default: False

Ignore non-alphanumeric characters while matching [boolean]

If checked, non-alphanumeric characters in the categories and symbols names will be ignored, allowing greater tolerance during the match.

Default: False


Categorized layer [vector: any]
Input vector layer with the categorized style applied. No new layer is output.
Non-matching categories [table]


Lists categories which could not be matched to any symbol in the provided style database.

Non-matching symbol names [table]


Lists symbols from the provided style database which could not match any category.

Topological coloring

Assigns a color index to polygon features in such a way that no adjacent polygons share the same color index, whilst minimizing the number of colors required.

The algorithm allows choice of method to use when assigning colors.

A minimum number of colors can be specified if desired. The color index is saved to a new attribute named color_id.

The following example shows the algorithm with four different colors chosen; as you can see each color class has the same amount of features.


Topological colors example


Input layer [vector: polygon]
Polygon vector layer.
Minimum number of colors [number]

Minimum colors number to assign.

Default: 4

Minimum distance between features [number]

Prevent nearby (but non-touching) features from being assigned equal colors.

Default: 0.0

Balance color assignment [enumeration]

Options are:

  • 0 — By feature count

    Attempts to assign colors so that the count of features assigned to each individual color index is balanced.

  • 1 — By assigned area

    Assigns colors so that the total area of features assigned to each color is balanced. This mode can be useful to help avoid large features resulting in one of the colors appearing more dominant on a colored map.

  • 2 — By distance between colors

    Assigns colors in order to maximize the distance between features of the same color. This mode helps to create a more uniform distribution of colors across a map.

Default: 0


Colored [vector: polygon]
Polygon vector layer with the addition of the color_id column.