SDK for including the UserVoice feedback system into iPhone applications
Objective-C C Shell
Switch branches/tags
Nothing to show
Pull request Compare This branch is 2 commits ahead, 784 commits behind uservoice:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


The UserVoice iOS SDK allows you to embed UserVoice directly in your iOS app. You will need to have a UserVoice account for it to connect to.

Binary builds of the SDK are available for download.

We also have an example app on GitHub that demonstrates how to build and integrate the SDK.


  • Download the latest build.
  • Drag UVHeadeers, UVResources, and libUserVoice.a into your project.
  • Note that the .h files in UVHeaders do not need to be added to your target.
  • Add -ObjC to Other Linker Flags in the Build Settings for your target. (There is also an Other Linker Flags setting for your entire project, but that's not the one you want.)

See if you want to build the SDK yourself.

Obtain Key And Secret

  • Go to the admin section of your UserVoice account and click Channels under Settings.
  • Add an iOS App.
  • Copy the generated Secret and API key.


Once you have completed these steps, you are ready to launch the UserVoice UI from your code. Import UserVoice.h and create a UVConfig using one of the following options.


1. Standard Login: This is the most basic option, which will allow users to either sign in, or create a UserVoice account, from inside the UserVoice UI. This is ideal if your app does not have any information about the user.

UVConfig *config = [UVConfig configWithSite:@"YOUR_USERVOICE_URL"

2. SSO for local users: This will find or create a new user by passing a name, email, and unique id. However, it will only find users that were previously created using this method. It will not allow you to log the user in as an existing UserVoice account. This is ideal if you only want to use UserVoice with your iOS app.

UVConfig *config = [UVConfig configWithSite:@"YOUR_USERVOICE_URL"

3. UserVoice SSO: This is the most flexible option. It allows you to log the user in using a UserVoice SSO token. This is ideal if you are planning to use single signon with UserVoice across multiple platforms. We recommend you encrypt the token on your servers and pass it to the iOS app.

UVConfig *config = [UVConfig configWithSite:@"YOUR_USERVOICE_URL"


Then you will want to launch UserVoice from the appropriate place in your code. There are 3 options here as well:

1. Standard UserVoice Interface: The user can browse suggestions, leave comments, etc. This is the full experience of everything the SDK can do

[UserVoice presentUserVoiceInterfaceWithParentViewController:self andConfig:config];

2. Stand-alone contact form: Allow the user to submit a ticket without going through the other screens. The user doesn't even need to log in to submit a ticket.

[UserVoice presentUserVoiceInterfaceWithParentViewController:self andConfig:config];

3. Stand-alone suggestion form: Allows the user to submit an idea without going through the other screens.

[UserVoice presentUserVoiceInterfaceWithParentViewController:self andConfig:config];


You can share feedback on the UserVoice iOS SDK forum.


Currently the UI is available in English and French. We are using Twine to manage the translations.

To contribute to the translations, follow these steps:

  • Fork the project on Github
  • Edit the strings.txt file
  • Commit your changes and open a pull request

If you want to go the extra mile and test your translations, do the following:

  • If you are adding a language:
    • mkdir Resources/YOURLOCALE.lproj
    • touch Resources/YOURLOCALE.lproj/UserVoice.strings
  • Install the twine gem
  • Run ./ to generate the strings files
  • Run the example app (or your own app) to see how things look in the UI
  • Make note of any layout issues in your pull request so that we can look at it and figure out what to do.

Some strings that show up in the SDK come directly from the UserVoice API. If a translation is missing for a string that does not appear in the SDK codebase, you will need to contribute to the main UserVoice translation site.


Copyright 2010 UserVoice Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.