Skip to content
[DEPRECATED] An elegant messages UI library for iOS
Branch: develop
Clone or download
jessesquires Update JSQMessagesViewController.podspec
Probably a dozen times, people have forked this lib and published to CP without updating the spec, so then their fork is attributed to me. Prevent this kind of nonsense.

Recently happened again:
Latest commit 9343b8f Feb 7, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update issue and PR templates with deprecation info (#2178) Oct 31, 2017
Assets cherry pick d6cdf18 by @jstart from master Oct 17, 2016
Documentation Added to apps using this library (#2017) Feb 15, 2017
JSQMessages.xcodeproj Finished video thumbnail feature (#1823) Oct 17, 2016
JSQMessages.xcworkspace remove JSQSystemSoundPlayer as a dep. close #1649 Jun 7, 2016
JSQMessagesDemo Finished video thumbnail feature (#1823) Oct 17, 2016
JSQMessagesTests Added support to set placeholder insets (#1908). Close #1907 Dec 12, 2016
JSQMessagesViewController Add czech localization. (#2130) Jun 30, 2017
Screenshots png crush Sep 15, 2015
SwiftExample fix footer for header in swift example (#1833) Oct 17, 2016
.cocoadocs.yml update cocoadocs styles May 27, 2014
.gitignore update ignore. include Pods/ May 27, 2015
.travis.yml Update .travis.yml (#1937) Dec 5, 2016 Added support to set placeholder insets (#1908). Close #1907 Dec 12, 2016
JSQMessagesViewController.podspec Update JSQMessagesViewController.podspec Feb 7, 2018
LICENSE Update Jul 17, 2017

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.