# LazyVGrid A container view that arranges its child views in a grid that grows vertically, creating items only as needed. ``` nonisolated struct LazyVGrid where Content : View ``` ## Overview Use a lazy vertical grid when you want to display a large, vertically scrollable collection of views arranged in a two dimensional layout. The first view that you provide to the grid’s `content` closure appears in the top row of the column that’s on the grid’s leading edge. Additional views occupy successive cells in the grid, filling the first row from leading to trailing edges, then the second row, and so on. The number of rows can grow unbounded, but you specify the number of columns by providing a corresponding number of [`GridItem`](/documentation/SwiftUI/GridItem) instances to the grid’s initializer. The grid in the following example defines two columns and uses a [`ForEach`](/documentation/SwiftUI/ForEach) structure to repeatedly generate a pair of [`Text`](/documentation/SwiftUI/Text) views for the columns in each row: ``` struct VerticalSmileys: View { let columns = [GridItem(.flexible()), GridItem(.flexible())] var body: some View { ScrollView { LazyVGrid(columns: columns) { ForEach(0x1f600...0x1f679, id: \.self) { value in Text(String(format: "%x", value)) Text(emoji(value)) .font(.largeTitle) } } } } private func emoji(_ value: Int) -> String { guard let scalar = UnicodeScalar(value) else { return "?" } return String(Character(scalar)) } } ``` For each row in the grid, the first column shows a Unicode code point from the “Smileys” group, and the second shows its corresponding emoji:  You can achieve a similar layout using a [`Grid`](/documentation/SwiftUI/Grid) container. Unlike a lazy grid, which creates child views only when SwiftUI needs to display them, a regular grid creates all of its child views right away. This enables the grid to provide better support for cell spacing and alignment. Only use a lazy grid if profiling your app shows that a [`Grid`](/documentation/SwiftUI/Grid) view performs poorly because it tries to load too many views at once. ## Topics ### Creating a vertical grid [`init(columns:alignment:spacing:pinnedViews:content:)`](/documentation/SwiftUI/LazyVGrid/init(columns:alignment:spacing:pinnedViews:content:)) Creates a grid that grows vertically. --- Copyright © 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)