- Start a new Marketplace listing
- Submit your listing for review
- Understand the review process and timeline
- Know who can manage and delete a listing
Only public connections with an installation scope of Any workspace can be listed on the Marketplace. Internal connections and OAuth integrations limited to selected workspaces aren’t eligible. Installation scope is set when the connection is created and can’t be changed afterward — see Installation scope.
Start a new listing
1
Navigate to the Marketplace listing dashboard.
2
In the Listings section of the sidebar, select Connections.
3
Under Drafts, select Publish a connection.
4
Fill in the listing details, including:
- Listing name and description
- Category and tags
- Listing images and logo
- The public connection to associate with this listing
5
Save your listing as a draft. You can return to edit it at any time before submitting.
Submit for review
When your listing is ready, submit it for review from the Connections listing page.1
From the Listings > Connections page, find your draft listing.
2
Review all listing details to ensure they are complete and accurate.
3
Submit your listing for review by the Notion team.
Review process
The Notion team reviews every listing submission. Track the status of your submission from the Listings > Connections page in the Marketplace listing dashboard. See the FAQ below for review timelines. If approved, the listing appears in the Notion Marketplace. If changes are required, the Notion team sends feedback and you can resubmit after making updates.Who can manage a listing
To publish a connection, you need to be one of its connection owners and an owner or admin of your Marketplace profile. If more than one person owns the connection, any of them can start a draft from their own Marketplace profile. The listing belongs to the Marketplace profile whose submission the Notion team approves. Drafts and rejected submissions don’t reserve the connection. After a listing is approved, only that profile can edit or resubmit it, and other profiles don’t see Manage listing in the Developer portal. You can’t edit a listing while its submission is waiting for review. If you need to change something, wait for the Notion team’s response. To delete a connection that has a listing, you need to be a connection owner and an owner or admin of the Marketplace profile that published the listing. Deleting the connection also removes its listing from the Marketplace. If the connection’s first submission is still waiting for review, any connection owner can delete it.Connection gallery best practices
For guidance on the review process and best practices to get your connection approved, check out the Notion Connection Gallery Best Practices guide.Frequently asked questions
How long will it take for Notion to publish my submitted connection?
How long will it take for Notion to publish my submitted connection?
After submission, expect to hear back from our team within 5-10 business days via email. Check the status of your connection submission from the Listings > Connections page in the Marketplace listing dashboard.
What if my connection doesn't meet the requirements?
What if my connection doesn't meet the requirements?
The Notion team sends an email explaining why your listing was not approved. Check the status from the Listings > Connections page.
What if my connection is rejected?
What if my connection is rejected?
Connections are rejected for various reasons, from brand/trademark issues to quality concerns to situations where the baseline connection criteria isn’t met. We encourage developers to review our feedback, make necessary changes, and resubmit. Our goal is to help you create high-quality and valuable tools for the Notion community.
Do I need to list my public connection on the Marketplace?
Do I need to list my public connection on the Marketplace?
No. Public connections work independently of Marketplace listings. Listing on the Marketplace is optional and helps your connection reach a wider audience, but your connection can be used via its OAuth flow without being listed.
Can you point me to other helpful resources?
Can you point me to other helpful resources?