Deploying apps

Branding

If you'd like to make your app available for public use, you must meet a few branding requirements before we can list it in the Zendesk Marketplace. For details, see Branding in the Publish your App docs.

After you've gathered the required branding assets, you can submit your app for review. See Submit your app.

Uploading

After developing and testing an app, you can upload it to your Zendesk product so agents can start using it.

Note: In Zendesk Support and Zendesk Chat, you can only upload and install apps if your account is on the Professional plan or above.

For instructions, see Uploading and installing your private app in Zendesk Support.

If your Zendesk Support account is on the Essential or Team plan, Zendesk offers developers a free, sponsored Enterprise account for testing and debugging apps. The only condition is that you don't use the account to provide actual support. See Request a sponsored test account.

Zendesk strongly recommends using the Zendesk App Tools to validate and package your apps for uploading.

If you built a private app that other Zendesk users might find useful, submit it for the Zendesk Marketplace. To submit your app for approval, see apps.zendesk.com.

All apps must be uploaded in a zip format, and certain files must be included. See File requirements.

If you run into any uploading problems, we're happy to help in the Apps framework community.

App Internationalization

Internationalization is left to the app developer. However, you must provide a translations/en.json file. See File requirements for the Zendesk Marketplace.

Note: You could use the i18n module in the App Scaffold to localize your app. For details, see Using the i18n module in the App Scaffold on Github.

The en.json has a required "app" object that must contain the following 4 keys:

  • name - the name of your app
  • short_description - a short (no more than 80 characters) description shown next to the logo.
  • long_description - a long (3000 characters) description shown when looking at the specific app's page.
  • installation_instructions - content telling the user how to install the app (3000 characters).

These keys provide the content for your app on the Zendesk Marketplace.

You can also optionally provide:

  • parameters - provides friendly text for each configuration parameter defined in the manifest.json.
    • label - renames the label of the parameter
    • helpText - provides more detail on how to use this parameter. Supports Markdown.

Example en.json:

{
  "app": {
    "name": "Bookmarks",
    "short_description": "Quickly see your products",
    "long_description": "Access bookmarked tickets from our iPad & iPhone app",
    "installation_instructions": "Simply click the install button",
    "parameters": {
      "disable_conflicts_prevention": {
        "label": "Remove conflict prevention warnings",
        "helpText": "Check this to not show warnings when a conflict happens"
      }
    }
  }
}

Note: Only the English versions of the name, short_description, long_description, and installation_instructions are used on the Zendesk Marketplace.