coil README

The project's README from github.com/coil-kt/coil. As one markdown file: README.md.

Coil

An image loading library for Android and Compose Multiplatform. Coil is:

Coil is an acronym for: Coroutine Image Loader.

Translations: 日本語, 한국어, Русский, Svenska, Türkçe, 中文, پارسی, O'zbekcha

Quick Start

Import the Compose library and a networking library:

implementation("io.coil-kt.coil3:coil-compose:3.6.2")
implementation("io.coil-kt.coil3:coil-network-okhttp:3.6.2")

To load an image, use the AsyncImage composable:

AsyncImage(
    model = "https://example.com/image.jpg",
    contentDescription = null,
)

Check out Coil's full documentation here.

License

Copyright 2026 Coil Contributors

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

coil (coil-kt/coil)

Searching Database…

11.9K ·GitHub
What is this?Coil is an image loading library for Android and Compose Multiplatform, built on Kotlin Coroutines. It handles fetching, decoding, caching, and displaying images with minimal boilerplate.
Is it a standalone app or a library I add to my project?It's a library you add as a dependency to a Kotlin/Compose project, not a standalone app. 'Coil' stands for Coroutine Image Loader.
How do I add it to a project?Import the Compose library plus a networking library, then use the AsyncImage composable to load an image.
Do I need anything besides Kotlin to use it?Coil only depends on Kotlin, Coroutines, and Okio, plus a networking library (like OkHttp or Ktor) for fetching remote images.
Does it only work on Android, or also other Compose targets?It works on Android and also on Compose Multiplatform, so it's not limited to Android apps alone.
What makes Coil fast?Coil performs optimizations like memory and disk caching, downsampling images, and automatically pausing or cancelling requests that are no longer needed.
Why is it called Coil?Coil is an acronym for Coroutine Image Loader, reflecting its Kotlin-first, coroutine-based design.
Does it work with other modern Android libraries?Yes, it's designed to interoperate with Compose, Coroutines, Okio, OkHttp, and Ktor out of the box.
Is documentation available in other languages?Yes, the README is translated into Japanese, Korean, Russian, Swedish, Turkish, Chinese, Persian, and Uzbek.
Creator
coil-kt
Size
126.6 MB
Stars
11.9K
Age
7y
Commits · 90 Days