---
title: preferringMulticolor()
framework: uikit
role: symbol
role_heading: Type Method
path: uikit/uiimage/symbolconfiguration-swift.class/preferringmulticolor()
---

# preferringMulticolor()

Creates a color configuration that specifies that the symbol image uses its multicolor variant, if one exists.

## Declaration

```swift
class func preferringMulticolor() -> Self
```

## Return Value

Return Value A symbol configuration that acquires the multicolor variant of a symbol.

## Discussion

Discussion Use this method to acquire the multicolor variant of a symbol, if one exists. This method is the primary approach to retrieving multicolor symbols. For this color configuration to have an effect, your symbol image must have the following: Its renderingMode set to UIImage.RenderingMode.alwaysTemplate or UIImage.RenderingMode.automatic. Multicolor annotations. If your symbol doesn’t have multicolor annotations, the resulting image is a monochrome (template) symbol image. If you combine this configuration with a hierarchical or palette color configuration using applying(_:), the resulting symbol uses the multicolor variant, if one exists, and defaults to the hierarchical or palette variant otherwise.

## See Also

### Creating a color configuration

- [init(hierarchicalColor:)](uikit/uiimage/symbolconfiguration-swift.class/init(hierarchicalcolor:).md)
- [init(paletteColors:)](uikit/uiimage/symbolconfiguration-swift.class/init(palettecolors:).md)
- [preferringMonochrome()](uikit/uiimage/symbolconfiguration-swift.class/preferringmonochrome().md)