Skip to content
Related Articles

Related Articles

Improve Article
Save Article
Like Article

How to Create a CircularImageView in Android using hdodenhof Library?

  • Last Updated : 18 Feb, 2021

It is seen that many Android apps use CircularImageView to show the profile images, status, stories, and many other things but doing this with a normal ImageView is a bit difficult. So to do so use hdodenhof CircleImageView Library. It’s a fast circular ImageView perfect for profile images. This is based on RoundedImageView from Vince Mi. So in this article, let’s add a CircleImageView in the Android App. A sample image is given below to get an idea about what we are going to do in this article.


Note: To create a CircularImageView in Android without using any library please refer to How to create a Circular image view in Android without using any library?

Steps for Creating a CircularImageView

Step 1: Creating a New Project

To create a new project in Android Studio please refer to How to Create/Start a New Project in Android Studio. Note that choose Java as language though we are going to implement this project in Java language.

Step 2: Before going to the coding section first do some pre-task

  • Go to Gradle Scripts -> build.gradle (Module: app) section and import the following dependencies and click the “sync Now” on the above pop up.

implementation ‘de.hdodenhof:circleimageview:3.1.0’

Step 3: Designing the UI 

  • Create a CircleImageView inside the activity_main.xml file and set the android:src=”@drawable/mountain”. The complete code of the activity_main.xml file is given below.


<?xml version="1.0" encoding="utf-8"?>
    <!-- Circular Image View  -->

Step 4: file

Here in this project there is nothing to do with the file, so keep it as it is.


import android.os.Bundle;
public class MainActivity extends AppCompatActivity {
    protected void onCreate(Bundle savedInstanceState) {



  • In this library, the ScaleType is always CENTER_CROP and you will get an exception if you try to change it.
  • Enabling adjustViewBounds is not supported as this requires an unsupported ScaleType.
  • Using a TransitionDrawable with CircleImageView doesn’t work properly and leads to messed-up images.


My Personal Notes arrow_drop_up
Recommended Articles
Page :

Start Your Coding Journey Now!