Practice Now
Android
RecyclerView
GridLayoutManager
GridView
Android Development

Simple Android grid example using RecyclerView with GridLayoutManager like the old GridView

Interview Questions practice on Codemia

Over 8,000 real interview questions from top companies, searchable by company and role.

Browse interview questions
iOS & Android

Introduction

RecyclerView with GridLayoutManager is the recommended replacement for legacy GridView in modern Android apps. It offers better performance, flexible layouts, and clearer adapter patterns. A solid setup includes predictable item sizing, spacing, click handling, and efficient binding behavior.

Basic Grid Layout Setup

Define the RecyclerView in XML.

xml
1<?xml version="1.0" encoding="utf-8"?>
2<androidx.recyclerview.widget.RecyclerView
3    xmlns:android="http://schemas.android.com/apk/res/android"
4    android:id="@+id/recyclerView"
5    android:layout_width="match_parent"
6    android:layout_height="match_parent"
7    android:padding="8dp"
8    android:clipToPadding="false" />

Initialize with GridLayoutManager in activity or fragment.

kotlin
1import android.os.Bundle
2import androidx.appcompat.app.AppCompatActivity
3import androidx.recyclerview.widget.GridLayoutManager
4import androidx.recyclerview.widget.RecyclerView
5
6class MainActivity : AppCompatActivity() {
7    override fun onCreate(savedInstanceState: Bundle?) {
8        super.onCreate(savedInstanceState)
9        setContentView(R.layout.activity_main)
10
11        val recycler = findViewById<RecyclerView>(R.id.recyclerView)
12        recycler.layoutManager = GridLayoutManager(this, 3)
13        recycler.setHasFixedSize(true)
14        recycler.adapter = GridAdapter((1..30).map { "Item $it" })
15    }
16}

This gives a simple three-column grid similar to classic grid behavior.

Adapter and ViewHolder Implementation

Keep bind logic focused and avoid expensive work in onBindViewHolder.

kotlin
1import android.view.LayoutInflater
2import android.view.View
3import android.view.ViewGroup
4import android.widget.TextView
5import androidx.recyclerview.widget.RecyclerView
6
7class GridAdapter(
8    private val items: List<String>,
9    private val onClick: (String) -> Unit = {}
10) : RecyclerView.Adapter<GridAdapter.VH>() {
11
12    class VH(view: View) : RecyclerView.ViewHolder(view) {
13        val title: TextView = view.findViewById(R.id.title)
14    }
15
16    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): VH {
17        val view = LayoutInflater.from(parent.context)
18            .inflate(R.layout.grid_item, parent, false)
19        return VH(view)
20    }
21
22    override fun onBindViewHolder(holder: VH, position: Int) {
23        val item = items[position]
24        holder.title.text = item
25        holder.itemView.setOnClickListener { onClick(item) }
26    }
27
28    override fun getItemCount(): Int = items.size
29}

A callback-based click API keeps adapter reusable.

Add Consistent Grid Spacing

GridLayoutManager does not add classic GridView spacing automatically. Use ItemDecoration.

kotlin
1import android.graphics.Rect
2import android.view.View
3import androidx.recyclerview.widget.RecyclerView
4
5class GridSpacingDecoration(
6    private val spanCount: Int,
7    private val spacing: Int
8) : RecyclerView.ItemDecoration() {
9
10    override fun getItemOffsets(outRect: Rect, view: View, parent: RecyclerView, state: RecyclerView.State) {
11        val position = parent.getChildAdapterPosition(view)
12        val column = position % spanCount
13
14        outRect.left = spacing - column * spacing / spanCount
15        outRect.right = (column + 1) * spacing / spanCount
16        if (position < spanCount) outRect.top = spacing
17        outRect.bottom = spacing
18    }
19}

Apply once:

kotlin
recycler.addItemDecoration(GridSpacingDecoration(3, 16))

This improves visual consistency across screens.

Efficient Image Grids

If grid items include images, use an async image library instead of manual bitmap decode.

kotlin
1// Example with Coil inside onBindViewHolder
2// imageView.load(url) {
3//     crossfade(true)
4//     placeholder(R.drawable.placeholder)
5// }

Avoid decoding bitmaps on main thread. Main-thread decode causes dropped frames and poor scroll performance.

Span Customization

You can mimic mixed-size tile layouts by customizing span size.

kotlin
1val layoutManager = GridLayoutManager(this, 3)
2layoutManager.spanSizeLookup = object : GridLayoutManager.SpanSizeLookup() {
3    override fun getSpanSize(position: Int): Int {
4        return if (position % 7 == 0) 3 else 1
5    }
6}
7recycler.layoutManager = layoutManager

This is a common pattern for featured-card sections.

Migration Tips from Old GridView

When migrating:

  • Move click logic into adapter callbacks.
  • Replace old adapter with view holder pattern.
  • Add explicit spacing decoration.
  • Validate accessibility and focus behavior.

Migration is usually easiest when one reusable grid component is created and shared across screens.

Common Pitfalls

  • Inflating item views incorrectly with wrong parent parameters.
  • Doing expensive transforms in onBindViewHolder.
  • Forgetting spacing decoration and getting cramped layouts.
  • Failing to handle data updates with proper adapter notifications.
  • Ignoring accessibility labels and touch targets in grid items.

Summary

  • Use RecyclerView plus GridLayoutManager as the modern GridView replacement.
  • Keep adapter binding lightweight and callback-driven.
  • Add explicit spacing and stable item sizing for consistent UI.
  • Use async image loading for media-heavy grids.
  • Build one reusable grid pattern and apply it consistently across app screens.
Related reading
Free course
Beginner
7 lessons
2 hours
Tackling System Design Interview Problems

A short course that equips you with the skills to approach system design interviews methodically.

Start the free course
Track what you have practised

A free account saves your progress, solutions and study plan across every problem on Codemia.

Interview Questions practice on Codemia

Over 8,000 real interview questions from top companies, searchable by company and role.

Browse interview questions
Codemia
© 2026 Codemia
Resources
Legal
Social
All Rights Reserved.