Filling out your app card
Your app listing (or app card) is your app’s display to potential customers on the QuickBooks app store. Use it to tell your potential customers what your app does for them, how it works, and what you charge. Include app features and benefits as well as any other
information that helps readers decide if your app solves their problem.
The best app cards are clear, concise, and convey specific value to your customers. Think about the competitive differentiators of your app, and use the app card to explain them.
Access and modify your app listing
- From the menu at the top-right select Dashboard and open your app.
- Click the List on the app store section.
- If you haven’t completed verification requirements you will have do this first.
- Click Create a listing.
- You can fill out a listing by clicking start under App cards by country for any or all regions supported.
- You can copy listing details from any region with the copy from dropdown.
HTML support in text fields
In general, the following HTML tags are allowed in app card descriptive text fields.
- Basic: <h1>, <h2>, <h3>, <p>
- Links: <a>
- Lists: <ul>, <li> (only inline styling supported)
- Styles: <div>, <span>
- Formatting: <b>, <code>, <small>, <strike>, <strong>, <sub>, <sup>, <u>
- Tables: <table>, <thead>, <tbody>, <tr>, <td>
App listing fields
Click in the icon area (indicated by an image of an outlined green cube) to upload a thumbnail for your app listing.
A short descriptive statement that sells your app, like: *Easy expense management for small businesses on the go!* Maximum 80 characters.
Enter the web address (URL) for your company. This can be your company’s home page or a product page. Maximum 1024 characters.
Highlight app features and benefits in a 30-60 second video. Enter only a Vimeo or YouTube URL that begins with https and follows this format:
- For Vimeo: https://player.vimeo.com/video/yourvideoID
- For YouTube: https://www.youtube.com/embed/yourvideoID
Maximum 1024 characters.
Enter at least two and up to six screenshots.
These images appear as thumbnails that visitors click to enlarge. Illustrate specific portions of your app (not an entire screen, which is hard to read) and annotate or highlight important features. Images must be .png or .jpg format, and measure 640w x 400h pixels.
Quick, short paragraphs that list the main benefits provided by your app. At least one is required in order to publish. Maximum 250 characters per benefit.
How it works with QuickBooks
Use this section to explain how your app interacts and enhances the user experience with QuickBooks Online.
A short introductory description that shows on your app card. To enhance your search results, mention that your app integrates with QuickBooks Online. Lead with benefits your app provides so readers know how your app will help them save money, save time, or increase revenue. Maximum 250 characters.
Intuit strongly recommends that you offer a free trial to let users test out your app. Free trials are usually 7 to 30 days long, depending on how complex an app is. Consider how long it takes to see the benefits your app offers, and be sure to include time for set-up and learning.
There’s no need to require a credit card for free trial, and doing so is a proven barrier to sign-ups.
- Overview: A short, clear description of your pricing or plans. Price details appear on your app card’s Pricing tab. Maximum 250 characters.
Keep this text as short as possible. Use no more than 4-5 lines of text, don’t add extra line breaks with something like: 14 day free trial, no credit card required, plans start at $29/mo.
- Plans: You may choose up to five pricing plans for each app. You must choose at least 1. Customize pricing information by including the locale’s currency. For example, $19 USD, $25 AUD, and so on.
- Name: The price plan name as it appears in the PLAN column. Maximum 50 characters.
- Pricing: A description of the pricing for this plan as it appears in the PRICE column.
- Number of Users Type: Can be either specific or unlimited.
- Number of users - Specific: Specify the number of users for this plan. This will show in the USERS column of your pricing tab.
- Description: A short description about the pricing plan is shown in the DETAILS column. Maximum 250 characters. Your potential customer sees the plan(s) when they click the Pricing tab.
Enter 1 to 4 frequently-asked questions and their answers. FAQs appear on your app card’s Support tab. Each question is limited to 250 characters, each answer is limited to 500 characters.
*Tip: Common questions include: Is my data secure?, What QuickBooks data is synced with this app?, and Why should I use this app when QuickBooks already offers [blank] features? Enter only text. No HTML or bullets or list.
You must support your app. Your support contact information appears on your app card’s Support tab.
- Support description (optional): A description of your support program that tells customers what to expect from you if they have questions or problems. For example, include information about support channels, days and hours of support, expected response times, and so on. Maximum 500 characters.
- Support page URL: The full web address of the support contact page on your website. Maximum 1024 characters.
- Support email: An email address that users can reach out to for support. This field is required if you have not provided a valid entry for
Support phone number, below.
- Support phone number: The phone number (including country code) site visitors and your customers use to contact your support team. This field is required if you have not provided a valid entry for
Support email, above.
Analytics & Meta
This section contains additional optional fields.
- Google Analytics ID:You can use your Google Analytics tracking ID to track key metrics on your app card listing. Look for the corresponding field on the App Settings page.
- META Tags: Keywords that are typically used by search engines, including those for apps.com and the QuickBooks Online Apps tab. Sample keywords: “QuickBooks data, save money, Integrate with QuickBooks”. Maximum 250 characters.
- META Description: Meta descriptions are commonly used on search engine result pages to display a preview snippet. They don’t impact rankings, but do improve click-through. This text lives in the header of your app card HTML source code. Maximum 1000 characters.
Here’s how a description snippet appears in search engine results:
Preview your app card
At any point during the edit session, you can preview your app card by clicking Preview app card to the right of the edit panel.
Win more global business with country-specific app cards
Don’t just customize your app to work well for businesses in different countries, customize your marketing message too. Complete a custom app card for each individual country. Hone your message and speak directly to different international audiences with targeted product taglines, descriptions,
pricing plans, support info, FAQ, and app features/screenshots.
Submit your app
Now that you’ve filled out all your app card information and you’re sure your app meets all technical and security requirements, check out the
marketing requirements to ensure that your app listing complies. If so, you’re ready to submit.
Intuit Single Sign-On settings
These settings impact how your app interacts with the QuickBooks app store and how users sign into your app. Refer to the section below that corresponds to your app’s authentication model.
- Permalink: Enter a string to customize your app’s URL on the QuickBooks app store. For example, entering “AccountingApp” sets your app listing’s URL to
- Intuit Single Sign-On?: Specify whether your app uses Intuit Single Sign-On. If not, you must provide a URL that users can click to learn more details about your app (see Learn more URL below).
- Category: To improve searchability as users browse for apps, select the category that your app belongs to.
For apps using Intuit Single Sign-On
- Connect Request URI: For apps that implement OAuth 2.0, the location in your app to which users are directed upon clicking the Get App Now button. This location initiates the OAuth 2.0 workflow. Upon completion of the OAuth 2.0 workflow, the user is redirected to your app’s dashboard,fully connected to the QuickBooks company.
- Host Domain: Your app site domain name. Since your production environment may be different than your development environment, you must provide URLs for both.
- Launch URL: This is a placeholder for your app’s Launch link.For apps planning to publish on the QuickBooks App Store, this will be the link to the page that implements single sign-on. When Launch is clicked from Quickbooks company, Intuit will call this URL and your app should start the OpenIdConnect (OAuth2) process with OpenId+Email etc. scopes(Do not send accounting). You’ll get back the authorization code & realmId in the callback url and you should be able to obtain the id token and email to determine which user this is and take them to your app’s dashboard page.
- Disconnect URL: This is a placeholder for your app’s Disconnect link.When Disconnect is clicked from Quickbooks company, Intuit will revoke the token internally and Your user lands on this page after the app disconnects from your user’s QuickBooks company. This url should again perform an OpenIdConnect (OAuth2) process as shown for Launch above, by sending scope as only OpenId+Email etc. (Do not send accounting). Implement the Connect to QuickBooks button and single sign-on on this page using API related scopes like for Accounting, Payments etc so that users can reconnect immediately. So, through this link, when a customer disconnects, Intuit passes your app an OpenID assertion about the user that just disconnected from your app. You can use that assertion to look up the user and mark them as disconnected or send them a message.
OAuth 1.0 will be disabled as of December 17, 2019. If you are currently using OAuth 1.0 for your apps (including apps still under development), be sure you migrate to OAuth 2.0 and (if applicable) OpenID Connect by December 17, 2019.
Intuit Non Single Sign-On settings
Refer to the section below that corresponds to your app’s authentication model.
For apps not using Intuit Single Sign-On
When you have selected No for the Intuit Single Sign-On field, these options will be available.
- Learn more URL: This is the URL that the Learn More button uses. It redirects users to this link; ideally, the link should contain more information about your app, including pricing, demo/trial information (if available), and details on how to get or install the app. This page should also discuss how the app is used and how it integrates with QuickBooks.
- Host Domain: Your app site domain name. Since your production environment may be different than your development environment, you must provide domains for both. Note, this is domain only, no protocol.
- Launch URL: This is a placeholder for your app’s Launch link. The launch URL should be set to your app’s login page.
- Disconnect URL: This is a placeholder for your app’s Disconnect link.The Disconnect URL should be a static page which informs the user that their QuickBooks connection has been terminated and provide instructions on how to reconnect to QuickBooks from within your app.