App Center Docs

Changelog

Last updated: Jan 27, 2025

New apps approval process

Jan 27, 2025

Described the new app review process on the Create your app page.

showLoginModal

Nov 26, 2024

Added new JS SDK method showLoginModal.

Extra user data

Aug 21, 2024

The new extra_user_data field in JWT describes the state of the trial subscription to the app.

New Structure

Jul 16, 2024

The App Center Docs structure updated to improve readability and navigation.

Redirects inside iframe

Jun 26, 2024

New section added to the iframe integration guide, covering redirects to other domains inside the iframe.

New article added to the App Management section, covering test app creation and editing.

App Admin management

Apr 8, 2024

The new User permissions article describes available types of permissions and how App owners can manage the Admin permissions.

All partner app requirements in one section

Mar 21, 2024

The new Requirements section outlines all the preconditions necessary for a partner app to successfully pass the review process. This includes requirements related to branding, security, configuration, scripts, and other considerations.

Notification management details

Mar 20, 2024

Added more info on how users can manage email subscription preferences.

Jan 10, 2024

Added info about navigating through links in your app. To open app links in the same tab without reloading the page, follow the new guidelines.

Email reports on free apps and search parameters in SM.config

Dec 13, 2023

Free apps now have the same email reports functionality as paid apps.

SM.config now returns allowedGetParams array.

Information about managing email mailings

Nov 22, 2023

Information has been added on how users can manage their email subscription preferences.

Iframe integration guide

Nov 17, 2023

We've added more detailed information about iframe integration, including an FAQ section.

Guide on search parameters

Nov 9, 2023

Check out our new guide on working with search parameters.

More info about errors in S2S API

Oct 31, 2023

We've added more comprehensive information about errors in Server-to-server API.

New fields in JWT and S2S

Oct 5, 2023

We've added fields is_main_product_trial_available and product_trials_available to JWT, getAccessToken, viewer status report and email reports.

New SDK method for logging

Aug 23, 2023

We've added a new method setLogging to handle JS logging.

Email notifications info updated

June 22, 2023

We've updated information about JS SDK methods requestEmailReports and requestEmailSubscriptionChange, and the email_subscription JWT key. The difference between these methods is now clearer.

Design checklist

February 13, 2023

Before submitting your app while integrating, take a look at the design checklist and check out the common issues your app may have.

Migration guide for fixed layout

January 27, 2023

Great news! We've added the migration guide which helps you to switch to the new fixed type of app layout. Now you don’t have to worry about the double scrollbar and can focus on other important things!

User notifications

January 16, 2023

Check out our new server-to-server API feature for sending and scheduling email notifications for your app!

Landing guidelines

November 18, 2022

We’ve pulled together our recommendations for arranging the landing page for your app, now you can find guidelines on the app name, icon, description, and screenshots in one place.

New SDK method for resizing

November 1, 2022

We’ve made the brand-new method for avoiding the double scrollbar and making your iframe height match the app content.

New requests to App Center server-to-server API

August 12, 2022

We've added new options for requesting data from the App Center server-to-server API!

Now you can get a Backlink report and a Domain summary report.

Test payments

August 3, 2022

We've launched Test purchases!

You can use test mode to purchase your app and in-app features without actually spending real money and subscribing to Semrush.

Add new types of apps

July 21, 2022

The requestAppInstall method is deprecated. Long live the requestMainProductPurchase!

We changed the whole concept of getting apps, where purchasing used to be equal to installing. Remember that? So, that doesn't work anymore, because we’ve added new types of apps: free apps and freemium apps. Now users can get those apps without making a purchase.

That's why we needed something new to manage it and created the requestMainProductPurchase method and its JWT parameter friend is_main_product_active. Now we can separate paid apps from free and freemium apps: for paid apps, the is_main_product_active parameter in the JWT payload is true after purchasing. For free and demo freemium apps, the is_main_product_active parameter in the JWT payload is false.

Take a look at all options available and learn more about the new method.