Latest 1.0.2
License MIT
Platforms ios 9.0

Build Status

Table of Content


WLEmptyState is an iOS based component that lets you customize the message when the dataset of UITableView is empty. We created a sample project with the WLEmptyState component to show how you can use it.

Running an Example Project

To run the Example project:

  1. Clone the repo with the following command:

    git clone [email protected]:wizeline/WLEmptyState.git

  2. Move to the Example directory and run the following command:

    pod install

Installing WLEmptyState

WLEmptyState is available through CocoaPods. To install it, add the following command to your Podfile:

pod 'WLEmptyState'

Configuring WLEmptyState

The WLEmptyState component uses Method Swizzling. Therefore, to configure WLEmptyState, follow these steps:

  1. Import the module in the AppDelegate class by adding import WLEmptyState.

  2. Call the static method configure() on application(_ application:, didFinishLaunchingWithOptions:) method.

    Your AppDelegate class should look like this:

    import WLEmptyState
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        return true

Using WLEmptyState

Once you have configured WLEmptyState, you can use it for your UITableViewController. You need to conform the WLEmptyStateDataSource protocol. For example,

class YourTableViewController: UITableViewController, WLEmptyStateDataSource {

    override func viewDidLoad() {
        tableView.emptyStateDataSource = self


After you run your project with an empty dataset for a table, you’ll be able to see a default WLEmptyState view.

Default Image

Default WLEmptyState

Customizing WLEmptyState

If you want to customize the text, description, or image, you need to implement the WLEmptyStateDataSource function. You can find the code for customization in the following list:

  • Customize Image
func imageForEmptyDataSet() -> UIImage? {
    return UIImage(named: "bubble_icon")
  • Customize Title
func titleForEmptyDataSet() -> NSAttributedString {
    let title = NSAttributedString(string: "No messages", attributes: [NSAttributedString.Key.font: UIFont.preferredFont(forTextStyle: .headline)])
    return title
  • Customize Description
func descriptionForEmptyDataSet() -> NSAttributedString {
    let title = NSAttributedString(string: "There's no messages to show.", attributes: [NSAttributedString.Key.font: UIFont.preferredFont(forTextStyle: .caption1)])
    return title

Customized Image

Contributing to WLEmptyState

We actively welcome your pull requests. We are trying to make contributions to this project as transparent and accessible as possible, please read our Contributing guidelines and follow the Code of conduct.
If you face any problem with the code, please open an issue on GitHub.

List of Contributors. ⭐️


WLEmptyState is available under the MIT license. See the LICENSE file for more info.

Latest podspec

    "name": "WLEmptyState",
    "version": "1.0.2",
    "summary": "Custom view for Empty states on tables",
    "description": "A control to display a place holder in case there's no data on a UITableView",
    "homepage": "",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    "authors": {
        "Wizeline iOS Team": "[email protected]"
    "source": {
        "git": "",
        "tag": "1.0.2"
    "platforms": {
        "ios": "9.0"
    "pod_target_xcconfig": {
        "SWIFT_VERSION": "4.0"
    "swift_version": "4.0",
    "source_files": "WLEmptyState/Classes/**/*",
    "resource_bundles": {
        "WLEmptyState": [

Pin It on Pinterest

Share This