Skip to content

Import Apps

What is Import Apps

Import Apps is a bulk import feature that allows App Managers to quickly add multiple applications to their organization by uploading a CSV file. This is ideal for organizations that want to rapidly populate their application catalog without manually entering each app one by one.

With Import Apps, you can:

  • Import dozens or hundreds of applications at once
  • Automatically assign owners and editors to each application
  • Send invitations to users who aren't yet members of your organization

How to access Import Apps

  1. Navigate to the Applications page
  2. Click the Import Apps button next to Add App

Info

Only App Managers and Org Admins can access the Import Apps feature.

CSV File Format

Your CSV file should include the following columns:

Column Required Description
name Yes The display name of the application
shortname Yes A URL-safe identifier (letters, numbers, dashes, underscores only, no spaces)
summary No A brief one-line description of the application
description No A detailed description of what the application does
logo_url No A URL to the application's logo image
owners No Email addresses of app owners, separated by semicolons
editors No Email addresses of app editors, separated by semicolons

Example CSV

name,shortname,summary,description,logo_url,owners,editors
Slack,slack,Team communication platform,Slack is a messaging app for business.,https://example.com/slack.png,owner@company.com,editor1@company.com;editor2@company.com
Jira,jira,Project tracking software,Jira helps teams plan and track work.,https://example.com/jira.png,pm@company.com,dev@company.com

Tip

Download the template CSV from the Import Apps page to get started with the correct format.

How to import applications

Step 1: Download the template (optional)

Click Download Template on the Import Apps page to get a pre-formatted CSV file with example data. You can use this as a starting point.

Step 2: Prepare your CSV file

Create or edit your CSV file with your application data:

  • Ensure name and shortname are filled in for each row
  • Use semicolons (;) to separate multiple email addresses in the owners and editors columns
  • Make sure shortnames are unique and URL-safe (no spaces or special characters)

Step 3: Upload and preview

  1. Click Choose File and select your CSV file
  2. Click Preview Import
  3. Review the preview table:
    • Ready - App will be imported successfully
    • Warning - App will be imported but has minor issues
    • Error - App cannot be imported due to validation errors

Step 4: Import

If your preview shows valid apps, click Import X App(s) to create the applications.

After import:

  • Applications are created in your organization
  • Users listed as owners/editors who are already members are assigned to the apps
  • Users who aren't members receive email invitations to join your organization

Validation and error handling

Import Apps validates your data before importing:

Required field validation

  • name and shortname are required for each row
  • Rows missing required fields will show an error

Shortname validation

  • Must contain only letters, numbers, dashes (-), and underscores (_)
  • Cannot contain spaces
  • Must be unique within your organization
  • Cannot duplicate an existing app's shortname

Email validation

  • All email addresses must be in valid format
  • Invalid emails will show an error

Duplicate detection

  • If the same email appears as both owner and editor, you'll see a warning (the user will be added as owner)
  • Duplicate shortnames within the CSV will show an error

User invitations

When you import apps with owners or editors who aren't members of your organization:

  1. The import creates the applications
  2. Invitation emails are automatically sent to non-member email addresses
  3. When users accept the invitation and join, they can be assigned to their apps

Info

Users who are already members of your organization are automatically assigned as owners or editors without needing an invitation.

Best practices

  1. Start with the template - Download the template CSV to ensure correct formatting
  2. Test with a small batch first - Try importing 2-3 apps to verify your CSV format is correct
  3. Use consistent shortnames - Shortnames become part of URLs, so keep them short and descriptive
  4. Verify email addresses - Double-check owner and editor emails to avoid sending invitations to wrong addresses
  5. Prepare descriptions - Having good summaries and descriptions helps users understand each application's purpose