Objective-C Swift Shell Ruby


JSQMessagesViewController banner

Build Status Version Status license MIT codecov Platform

⚠️ Announcement ⚠️

Development on version 8.0 of the library is underway. Learn more at #1216 and #1336.

Submit work for v8.0 to the develop branch.

Submit fixes for v7.3.x to the release_7.3 branch.

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 => 'https://github.com/jessesquires/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 10,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.