<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.0.0 -",
    "macOS: 10.15.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/SimpleMaterial/metallic",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation14SimpleMaterialV8metallicAA0D15ScalarParameterOvp"
  },
  "title" : "metallic"
}
-->

# metallic

A value that you set to control whether the material has a metallic look.

```
var metallic: MaterialScalarParameter { get set }
```

## Discussion

This property defines whether a material is dielectric (`0.0`) or a metallic (`1.0`). Although
this property can be set to any value between `0` and `1`, to create a realistic material, set it
to either `0` or `1`.).

- Dielectric materials: These are materials that simulate real-world materials that are poor
  conductors. In these materials, light travels into the surface of the material and the color is mostly
  controlled by the color of the sub-surface. Typical examples of dielectric materaisl include organic
  materials, plastics, and industrial minerals such as sand, limestone,  marble, clay and salt.
- Metallic: A metallic (or *conductive*) material reflects light differently than dielectric ones.
  The overall color is caused by an immediate re-emission of the light from the entity’s surface. Typical
  examples of metallic materials include aluminum, chassis metal, chromium, copper, gold, silver, and
  titanium

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)