Skip to main content
The app details page is your app’s storefront and is also where creators land after installing your app, so make it count. app details page

​
What to include

Your app details page needs:
  • A clear description of what your app does
  • Setup instructions
  • Links to documentation
  • Link to where any settings for your app are hosted
  • Support information
  • Images and videos to help your app stand out
It may also include the option to alternatively send creators to your app, or an externally hosted onboarding flow, post signup. This can be configured using the Redirect URL after install field. An example of this flow can be seen below.
example redirect flow
example redirect flow

​
How to configure

Go to the top navigation menu “Automate” > “Apps” > “Build”. From there, click your app’s “Edit” button to display a form with fields for the app details page. Then, update these key fields:
FieldWhat it’s forRestrictionRequired for publishing
App nameThe name the creators see for your app across the entire Kit platform50 characters✅
IconYour app icon, which will be shown in all places where your app can be installed and used.Under 1 MB and 1,000 x1,000 pixels. Only JPEG and PNG are accepted.✅
SummaryA short description that helps market your app, primarily shown in the card for your app on the Kit App Store main page90 characters✅
DescriptionA longer description with markdown support that helps creators understand the value your app brings them, the functionality, and how to use it. It’s your opportunity to sell yourself to our massive creator base.5,000 characters✅
ImagesImages of your app to give creators a visual representation of what it looks like and the functionality availableUp to 10 images, 4,000 x 4,000 pixels. Only JPEG and PNG are accepted.✅
Demo video URLA video that demonstrates your app in action, to drive installations. If available, the video will appear before your app images.YouTube video URLs only
CategoriesThe category (or categories) your app belongs to✅
Requires a paid accountA toggle that identifies whether a paid account is required to use your app✅
Redirect URL after installSend users to your app, or an external onboarding flow, after they install it on Kit. Use this if setup continues on your platform. Kit will still handle authentication and track the installation before redirecting.valid https URL
Support URLTell your users where to reach out to if they encounter issues using your appvalid https URL✅
Help article URLA knowledge base/help center article for working with your appvalid https URL✅
Home page URLYour app website URLvalid https URL✅
App settings URLA URL that takes creators to a page in your app that allows them to manage the functionality of your app - from tag/custom field mapping, sync preferences and much morevalid https URL
Privacy Policy URLA link to your privacy policyvalid https URL✅

​
Markdown support

We currently offer the following markdown support for the app description:
  • Headings
    • # Heading 1
    • ## Heading 2
  • Lists
    • Unordered lists:
      • - item 1
      • - item 2
    • Ordered lists:
      • 1. Item 1
      • 2. Item 2
  • Formatting
    • **bold**
    • *italic*
    • <u>underline</u>
  • URL
    • [URL text](url)
For ease, we recommend using a free online markdown converter tool to help visualise your content as you draft it out, such as this, or utilize an LLM to convert the styling for you automatically.

​
Redirect handling

The OAuth redirect parameter automatically sends creators to your app details page after authentication. The URL format is: https://app.kit.com/apps/{app_id}
If you have already published an app, no changes are needed if you’re using our dynamic redirect parameter. Your creators will seamlessly move from installation to your getting started guide. Otherwise, you will need to update your authentication flow to end on the redirect parameter appended to the initial call to your configured authorization URL

​
Sharing your app with creators

Once you’ve populated the app details page form, click “Save” to save your changes. You can now go back to the Build page and select your app’s “Preview” option to preview its app details page: app details preview

​
Best practices

Your App Details Page is the primary way creators discover, learn about, and evaluate your app. For installation, it serves as both an educational and sales tool for convincing creators to try your app. Below are the components of a good App Details page:
1

Clear and Compelling Description:

Highlight your app’s purpose and how it enhances the creator’s experience. Include benefits for both the Kit integration and standalone use
2

Standalone & App-Specific Functionality:

Describe how the app works within Kit and what it offers independently as a standalone experience
3

Feature Set:

Provide a concise breakdown of key features and their value
4

Visual Content:

Best Practice: At least 2-3 high-quality images showcasing app functionality along with an annotation on features or benefits of the App - examples:

app details images
5

App Settings Configuration:

A configuration page lets creators customize how your app integrates with their Kit account—such as choosing which custom fields sync, toggling features on/off, or performing historical imports. This flexibility lets creators tailor the integration to their needs without unnecessary complexity. An example can be found below:

app setting page
6

Support Resources:

  • A general link to your app/platform support documentation
  • A Help Center Article specific to your Kit integration with:
    • Clear setup instructions
    • FAQs addressing common creator questions
7

An app video:

Adding a video to your app details page allows you to market your app to Kit creators even further, showcasing the benefits of your app in a new engaging way
For an example of a high-quality App Details page, click here.