Need help with NZCircularImageView?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

288 Stars 40 Forks MIT License 40 Commits 2 Opened issues


UIImageView class extension. Performs async download image and leaves with rounded edge, used for presenting pictures of user profiles.

Services available


Need anything else?

Contributors list

NZCircularImageView License MIT


NZCircularImageView is a UIImageView extension. Its performs async download image and leaves with rounded edge.

It can be used, for example, to presenting pictures of user profiles.

Build Status Cocoapods Cocoapods Analytics


NZCircularImageView works on iOS 6.0+ version and is compatible with ARC projects. It depends on the following Apple frameworks, which should already be included with most Xcode templates:

  • Foundation.framework
  • QuartzCore.framework
  • UIKit.framework

You will need LLVM 3.0 or later in order to build NZCircularImageView.

NZCircularImageView uses SDWebImage and UIActivityIndicator-for-SDWebImage to download async images.

Adding NZCircularImageView to your project


CocoaPods is the recommended way to add NZCircularImageView to your project.

  • Add a pod entry for NZCircularImageView to your Podfile
    pod 'NZCircularImageView'
  • Install the pod(s) by running
    pod install

Source files

Alternatively you can directly add source files to your project.

  1. Download the latest code version or add the repository as a git submodule to your git-tracked project.
  2. Open your project in Xcode, then drag and drop all files at
    folder onto your project (use the "Product Navigator view"). Make sure to select Copy items when asked if you extracted the code archive outside of your project.
  3. Install SDWebImage
  4. Install UIActivityIndicator-for-SDWebImage


The class overrides

, thus ensuring that every time an image is set, it will be presented in a rounded shape. This class also uses
contentMode with the
flag so that the image resolution is not changed.
  • Setting at Storyboard to automatic rounded image


  • Setting a rounded avatar image
circularImageView.image = [UIImage imageNamed:@"Default-Avatar"];
  • Async download image
// this method append parameters at url:
// - width: image view width
// - height: image view height
// - mode: crop (crop image from center)
[circularImageView setImageWithResizeURL:@""];
// ... with custom loading indicator
[circularImageView setImageWithResizeURL:kImageUrl
// ... with placeholder image
[self.imageView setImageWithResizeURL:kImageUrl
                     placeholderImage:[UIImage imageNamed:@"Sample"]

To enable the logs in debug/release mode, add

#define NZDEBUG
file in your project.


This code is distributed under the terms and conditions of the MIT license.


A brief summary of each NZCircularImageView release can be found on the wiki.

To-do Items

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.