Skip to end of metadata
Go to start of metadata

Titanium Modules provide JavaScript bindings for your application to use and access native features and libraries. Titanium Modules are linked (or bundled) at build time. They must be built to support the target architectures that your application is also targeting.

Finding and Downloading Modules

When looking for a specific Titanium Module, you should search gitTio: Follow the instructions on to download the modules.


Previously, the Appcelerator Marketplace was a location to find and download Titanium modules. The Appcelerator Marketplace is no longer used and Titanium artifacts are no longer available through the Marketplace in the AMPLIFY Platform. If you need access to a Titanium artifact, or if you have questions about artifacts that you have purchased through the Appcelerator Marketplace previously, please contact Axway at

Installing Modules

Once a module is downloaded, it must be installed in a specific project or in a shared global location.

Per-Project Installation

From Studio

  1. Open Studio.
  2. Expand the project folder in the Project Explorer view.
  3. Drag the .zip file from the download location into the current project, placing it at the root of the project. Choose to "Copy Files".

Automatic Unzip

Place the module zip file in the root of the project directory. The Titanium build will automatically extract all registered Titanium modules in the root of the project.

Manually Unzip

Extract the .zip file into the root of your project. It should extract into the modules/<platform>/<module-id>/<version> directory.

Global Installation

Modules can be globally installed in the following locations:

  • macOS
    • ~/Library/Application Support/Titanium (preferred)
    • /Library/Application Support/Titanium
  • Linux
    • ~/.titanium/modules
  • Windows
    • %ProgramData%\Titanium (preferred)
    • %APPDATA%\Titanium
      %ALLUSERSPROFILE%\Application Data\Titanium\

On macOS, the ~/Library directory may be hidden. Press Shift+Command+G in the Finder to open a dialog allowing you to navigate to the folder directly to ~/Library/Application Support/Titanium.

Using Your Module

To use your module in a mobile app, follow these steps:

Using the tiapp.xml Editor

Studio has a module section inside the tiapp.xml editor to greatly simplify the usage of modules. In order to use the module editor:

  1. Double-click on the tiapp.xml file
  2. In the right-hand column, click the + to add a new module. It will show you a list of modules available in your global directory and in your project.
  3. Once you've added a module, clicking the pencil (edit) icon allows you to switch versions if there are multiple version available.
  4. If you wish to delete a module, click the x (delete) button to delete the module.

Switching a SDK will re-validate the modules based on their compatibility with the selected SDK. If they are not compatible, they will show warnings as appropriate, allowing you to update as appropriate.


  1. Open the module's .zip file, and look at the folder structure. The path will look like the following:

    • Folder Structure: modules/<platform>/<module-id>/<version>
    • Example: modules/ios/ti.greystripe/1.1
  2. Open Studio, and the tiapp.xml file for the project in question.
  3. Switch to the tiapp.xml tab.
  4. In the application's tiapp.xml, find the <modules/> node, and replace it with the new <modules> content. If you already have modules, just add a new node for the new module. Note that the "version" and "platform" attributes are optional. When "version" is not specified, the latest version of the module will be used (as of Titanium SDK 2.0.0), and the "platform" tag is only necessary when using a module that is not available on both platforms.

  5. Use the require function to load the module in the app's code, for example:

  6. The next time the app is launched or built, the module should be included with the application.
  • No labels