Skip to content
[DEPRECATED] An elegant messages UI library for iOS
Objective-C Swift Shell Ruby
Branch: develop
Clone or download
Pull request Compare This branch is 3 commits behind jessesquires:develop.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
Assets cherry pick d6cdf18 by @jstart from master Oct 17, 2016
Documentation Added to apps using this library (jessesquires#2017) Feb 15, 2017
JSQMessages.xcodeproj Finished video thumbnail feature (jessesquires#1823) Oct 17, 2016
JSQMessagesTests Added support to set placeholder insets (jessesquires#1908). Close je… Dec 12, 2016
JSQMessagesViewController Add czech localization. (jessesquires#2130) Jun 30, 2017
Screenshots png crush Sep 15, 2015
SwiftExample fix footer for header in swift example (jessesquires#1833) Oct 17, 2016
.cocoadocs.yml update cocoadocs styles May 27, 2014
.codecov.yml Update .codecov.yml Jun 5, 2016
.gitignore update ignore. include Pods/ May 27, 2015
JSQMessagesViewController.podspec Merge branch 'release_7.3' into develop Jul 22, 2016
LICENSE Update LICENSE Nov 7, 2015

No Maintenance Intended

⚠️ Deprecated ⚠️

This library is deprecated. Please read my blog post for details.

JSQMessagesViewController banner

Build Status Version Status license MIT codecov Platform

Screenshot0    Screenshot1   

Screenshot2    Screenshot3

More screenshots available at CocoaControls


See the website for the list of features.

Design Goals

  • Closely mimic iMessage style and behavior
  • SOLID design
  • Easy customization and extension for clients



  • iOS 7.0+
  • ARC


CocoaPods (recommended)

# For latest release in cocoapods
pod 'JSQMessagesViewController'

# Latest on develop
pod 'JSQMessagesViewController', :git => '', :branch => 'develop'

Getting Started

See the Getting Started guide!

Questions & Help

  • Review the FAQ.
  • Search issues for previous and current questions. Do not open duplicates.
  • StackOverflow is often the most appropriate place for questions and help. We have our own tag, jsqmessagesviewcontroller.
  • See the Migration Guide for migrating between major versions of the library.
  • Only ask questions that are specific to this library.
  • Please avoid emailing questions. I prefer to keep questions and their answers open-source.


Read the docs, available here via @CocoaDocs.

Core team


Please follow these sweet contribution guidelines.

Interested in becoming a core contributor with push access? See our onboarding guide for details.


Apps using this library

According to CocoaPods stats, over 36,000 apps are using JSQMessagesViewController. Here are the ones that we know about. Please submit a pull request to add your app! 😄


JSQMessagesViewController is released under an MIT License. See LICENSE for details.

Copyright © 2013-present Jesse Squires.

Please provide attribution, it is greatly appreciated.

You can’t perform that action at this time.