Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A lightweight callout view class for iOS mimicking UICalloutView.
Objective-C Ruby
branch: master

This branch is 10 commits ahead, 102 commits behind nfarina:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


SMCalloutView aims to be an exact replica of the private UICalloutView system control.

We all love those "bubbles" you get when clicking pins in MKMapView. But sadly, it's impossible to present this bubble-style "Callout" UI anywhere outside MKMapView. Phooey! So this class painstakingly recreates this handy control for your pleasure.


To use SMCalloutView in your own projects, simply copy the files SMCalloutView.h and SMCalloutView.m.

The comments in SMCalloutView.h do a lot of explaining on how to use the class, but the main function you'll need is presentCalloutFromRect:. You'll specify the view you'd like to add the callout to, as well as the rect defining the "target" that the popup should point at. The target rect should be in the coordinate system of the target view (just like the similarly-named UIPopover method). Most likely this will be target.frame if you're adding the callout view as a sibling of the target view, or it would be target.bounds if you're adding the callout view to the target itself.

You can study the included project's AppDelegate.m for a working example.

More Info

You can read more info if you wish in the blog post.

ARC Support

This class requires LLVM 4.0 with Automatic Reference Counting (ARC), enabled by default in modern Xcode projects.

MapView Support

So the original made bubbles but not for mapviews. This version merges code from U10Int's fork and adds support to use a totally customized view as it's callout.

Something went wrong with that request. Please try again.