Adding FullStory as a CocoaPods Pod

FullStory for Mobile Apps is available as an add-on for FullStory Business and Enterprise plans. As a result, this add-on is not available on FullStory Free or the FullStory Business trial. Please contact your Account Executive or reach out to our Support team here to learn more.

About this article

This article provides setup steps for adding FullStory as a CocoaPods Pod. 

CocoaPods Installation: adding the FullStory pod

For iOS applications that already use CocoaPods, FullStory distributes a pod specification that you can integrate directly into your existing Podfile

Follow these steps:

  • In your Podfile, in the section for your app's target, paste this line:

pod 'FullStory', :http =>

  • Run “pod install
  • Add a build phase for FullStory's asset uploader
    • In the project navigator, select your app's project
    • In the editor panel, select your app's target
    • Choose the Build Phases tab
    • Chose Editor > Add Build Phase > Add Run Script Build Phase
    • On the new “Run Script” phase, double-click on the “Run Script” label and rename to “Run FullStory Asset Uploader”
    • If it’s not already, re-order the build phase so it’s the last step
    • Click the disclosure triangle next to the build phase to expand it
    • Replace the body of the script with (it should all be on one line):
      "${PODS_ROOT}/FullStory/tools/FullStoryCommandLine" "${CONFIGURATION_BUILD_DIR}/${WRAPPER_NAME}"
  • To upgrade FullStory in the future, update the FullStory release URL in your Podfile and run “pod update FullStory

Next Steps

After you’ve completed this setup, return to Getting Started with iOS Recording to configure FullStory, review advanced features, and more.

Need to get in touch with us?

The FullStory Team awaits your every question.

Contact us