App listing guidelines

When submitting your app or integration to the Asana app directory, it’s important to ensure your listing meets standards. A well-crafted listing will help potential users understand the value of your app, how to integrate it with Asana, and how to get started.

This guide outlines the key elements needed for your app’s listing page, along with best practices and examples to help you create the best possible experience for users.

Please note: If you do not follow these guidelines or fail to complete your listing with all the necessary details, it may delay the process of getting your app published. Incomplete or substandard listings may result in additional review cycles, slowing down the approval process and limiting your app’s visibility to potential users. To ensure a smooth and timely listing, we encourage you to carefully follow all instructions and provide all required information.

Example app listing

Throughout this guide, we’ll use TaskFlow, a hypothetical app, as an example to illustrate how to craft effective listings. Here's an example of what this page may look like when displayed in the app directory:

Short description

The short description is a concise summary that clearly communicates the core benefit or action your app provides to users. It should highlight what makes your app stand out, with a focus on its key functionality. This section is usually the first thing users see, so it should quickly grab their attention and answer the question, "Why should I use this app?"

Guidelines

Start with a verb: Make the description action-oriented. Begin with an action word that explains what the app enables the user to do.
Highlight a distinct feature: The description should describe something unique your app does or a problemit solves, distinguishing it from existing Asana features.
Avoid generic descriptions: Do not make the app sound like a feature already included in Asana. Focus on the added value the app brings to Asana.
Be concise: Keep it short and to the point (1-2 sentences, ~100 words). Aim to communicate the core benefit in as few words as possible.
Focus on integration: If applicable, mention how your app integrates with Asana to streamline workflows or extend Asana’s capabilities.

Examples

Connect TaskFlow to Asana to automate task creation from emails, saving you time and keeping your team organized.
Sync TaskFlow with Asana to create custom workflows between your email, CRM, and project management tools.
Turn emails into actionable tasks in Asana and streamline your team’s productivity with TaskFlow.
Integrate TaskFlow with Asana to convert emails into tasks, automatically assign them, and track progress.

Long description

The app description should be concise, clear, and focused on the value your app adds when integrated with Asana. Explain what your app does, why it’s useful, and what specific problem it solves for users.

Guidelines

Start with a strong value proposition that explains the benefit to the user
Keep it concise (ideally 3-5 sentences) while highlighting key features and benefits (e.g., a bulleted list)
Avoid jargon or overly technical language that could confuse the user

Examples

TaskFlow helps teams automate their task management by connecting Asana with email, calendars, and other productivity tools. By converting incoming emails into Asana tasks, TaskFlow ensures that nothing slips through the cracks. Users can define rules to automatically categorize, prioritize, and assign tasks to team members, streamlining workflows and boosting productivity. Whether you're managing support tickets, client requests, or daily to-dos, TaskFlow ensures your team stays organized, efficient, and focused.
Streamline your team’s workflow by connecting TaskFlow to Asana, and automate task creation directly from your email inbox. TaskFlow lets you set custom rules to ensure every email turns into a well-organized task in Asana, complete with tags, due dates, and priorities. By eliminating the need for manual task input, you save time, reduce errors, and ensure that important emails are converted into actionable tasks automatically, keeping your team on track and focused.
With TaskFlow, easily sync your emails, CRM, and other tools with Asana to create seamless workflows. This integration allows you to automatically convert emails into actionable tasks in Asana, assign them to team members, and set deadlines. Whether you’re managing client inquiries, internal requests, or project updates, TaskFlow keeps everything in one place, giving your team more time to focus on high-impact work and reducing manual task entry.

Setup instructions

Users should have clear, easy-to-follow instructions on how to integrate your app with Asana. This section should guide the user from installation to configuration and usage. You may wish to include a troubleshooting section for common issues (e.g., permissions or sync errors), and/or link to a more detailed support page if necessary.

Guidelines

Break the instructions down into simple, easy-to-understand steps.
Include any prerequisites, such as account setup or API keys.
Use screenshots or GIFs to illustrate key steps.
Be sure to mention any specific Asana permissions or settings that need to be configured.

Example

How to connect TaskFlow + Asana

Getting started with TaskFlow and Asana is quick and easy. Follow these simple steps to connect the two and start automating your task management today:

Step 1: Install TaskFlow from the Asana App Directory by clicking the "Add to Asana" button.
Step 2: Log in to your TaskFlow account using your credentials.
Step 3: Grant TaskFlow access to your Asana workspace.
Step 4: Configure your preferred email-to-task rules in the TaskFlow dashboard.
Step 5: Start turning emails into tasks directly within Asana!

URLs

Provide helpful links to allow users to learn more about your app, access your app, and get support.

Guidelines

Include the company page URL so users can learn more about your company and product.
Include a support page URL or email for users who need help troubleshooting the app. You may also wish to include additional documentation, guides, and resources for your app.
Include an app landing page (or login page) URL so users can directly access your app.
Include a privacy policy URL to ensure transparency about how you handle user data and comply with legal requirements.

Examples

Company page URL: https://www.example.com
Support page URL: https://support.example.com
App page URL: https://app.example.com/login
Privacy policy URL: https://www.example.com/privacy-policy

Visual assets

Screenshots, logos, and other visuals are essential for users to quickly understand what your app looks like and how it integrates with Asana. High-quality, relevant images and videos will enhance trust and encourage engagement.

Guidelines

Provide a high-quality app icon (i.e., logo) that matches your app's branding. Recommended size: 128x128
Include app images, screenshots that show the app’s UI, particularly when it's integrated with Asana. Aim for clarity and relevance.
Include a link to a screencast or demo video that showcases how the app works with Asana. This should be a short, clear video (30 seconds to 2 minutes) that demonstrates key features and the integration process. Make sure the screencast shows real-life use cases, such as how tasks are created or managed in Asana through your app. This is essential for helping users understand the app's functionality and ease of use.

Examples

App logo: A professional, clean logo that reflects your app’s identity (e.g., TaskFlow Logo).
App images: Images showing how tasks from email appear in the Asana task list, task assignment interface, and workflow automation settings.
Screencast: A 60-second video showing how TaskFlow automatically turns emails into tasks in Asana, assigns them, and tracks progress.

Common issues

When submitting your app or integration, some common reasons for resubmission requests and delayed reviews include:

Inadequate app description: Listings that do not provide clear, detailed information about how the app or integration functions within the Asana environment may be flagged. Be sure to describe the app's key features, its specific use cases, and how it improves or extends Asana's functionality for users.
Unclear setup instructions: Step-by-step setup instructions are crucial for users to get started with your app. Listings with vague or incomplete instructions may require revision. Ensure your guide is clear, concise, and easy to follow, so users can successfully integrate your app with Asana.

By addressing these areas thoroughly, you can help speed up the approval process and provide users with a seamless experience.