Alix-MICHEL / IBLocalizable

Localize your views directly in Interface Builder with IBLocalizable

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool


Localize your views easily in Interface Builder with IBLocalizable.

Build Status Language CocoaPods Compatible Carthage Compatible Awesome GitHub license

With IBLocalizable, you can localize your views in Interface Builder easily. Simply set the new Localizable String property that shows up in Interface builder to the value that you added in your Localizable .string file. Most views can be localized this way without a single line of code.


Add .Package(url: "",majorVersion: 1) to your Package.swift

Add pod 'IBLocalizable' to your Podfile.

Add github "PiXeL16/IBLocalizable" to your Cartfile.

Manual Installation

  • Please note, installation via CocoaPods or Carthage is much simpler and recommended.

Download and drop /IBLocalizable in your project.

Supported Views

  • UILabel
  • UIButton
  • UINavigationItem (Navigation titles)
  • UIBarItem (BarButton, TabBarItem, etc)
  • UITextField
  • UITextView
  • UISearchBar

Supporting custom views

Custom views can be supported easily. Just create an extension and implement the Localizable Protocol.

If your custom view extends from UIView you only need to extend your custom view and implement the localizableProperty.

For example: lets say that I have a custom view that contains several UILabel and a UIImageView. I will like to localize one of the UILabel.

import UIKit
extension MyCustomView {

    public override var localizableProperty: String?{

            return self.label.text
            self.label.text = newValue

Thats it! 😄.


After the package its installed simply open your Storyboard or Interface Builder. All of the supported views will show a new Localizable String property.


Since everything is extension based, IBLocalizable should play nice with other libraries or pods that you are using.

Build Performance

Since IBLocalizable only uses IBInspectable and never IBDesignable, your incremental builds will continue to work. (

Sample Project

In the Xcode Project you can find a sample project of a simple Login view controller. All of this is automatically localizable in English and Spanish by just using IBLocalizable.





To do

  • Support more views (TableView Cells, etc)
  • Improve sample project.


Chris Jimenez -, @chrisjimeneznat


IBLocalizable is released under the MIT license. See LICENSE for details.


Localize your views directly in Interface Builder with IBLocalizable

License:MIT License


Language:Swift 63.7%Language:Ruby 34.3%Language:Objective-C 2.0%