<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.0.0 -",
    "macOS: 11.0.0 -",
    "tvOS: 13.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 6.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/View/imageScale(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI4ViewPAAE10imageScaleyQrAA5ImageV0E0OF"
  },
  "title" : "imageScale(_:)"
}
-->

# imageScale(_:)

Scales images within the view according to one of the relative sizes
available including small, medium, and large images sizes.

```
nonisolated func imageScale(_ scale: Image.Scale) -> some View
```

## Parameters

`scale`

One of the relative sizes provided by the image scale
enumeration.

## Discussion

The example below shows the relative scaling effect. The system renders
the image at a relative size based on the available space and
configuration options of the image it is scaling.

```
VStack {
    HStack {
        Image(systemName: "heart.fill")
            .imageScale(.small)
        Text("Small")
    }
    HStack {
        Image(systemName: "heart.fill")
            .imageScale(.medium)
        Text("Medium")
    }

    HStack {
        Image(systemName: "heart.fill")
            .imageScale(.large)
        Text("Large")
    }
}
```

![A view showing small, medium, and large hearts rendered at a size](images/com.apple.SwiftUI/SwiftUI-View-imageScale@2x.png)

---

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)