The items listed in this section ensure that your app successfully undergoes the review process. These requirements address additional considerations crucial for confirming seamless functionality across platforms and for enhancing speed and responsiveness, thereby improving the user experience.
We use Lighthouse as an auditing tool—an open-source, automated tool designed to enhance webpage quality. You can run it against any webpage, whether public or requiring authentication.
Your app must achieve a Lighthouse performance score of 60 or higher.
Your app must support the following browsers:
Google Chrome, Mozilla Firefox, Opera, and Microsoft Edge: All versions released in the past six months.
Safari: The two latest versions. Safari has a slower release cycle, so we rely on versions rather than a fixed time frame.
Your app must work correctly in incognito or private browsing mode. This mode lets users browse the web without storing local data such as cookies, browsing history, or cached files. Ensuring seamless functionality in incognito mode is essential for providing users with a consistent and reliable experience, regardless of their browsing preferences or settings.
Your app must work correctly when its elements are opened in a new browser tab. Specific requirements include:
Instead of the iframe URL or core product domain, links from your app must open in the semrush.com domain.
Call the SM.client('pushUrl', ...)
method when a user clicks a link within your app.
Process the URL from the iframe JWT.
When your app is unavailable or something goes wrong, users must be notified through an error message presented in clear and user-friendly language. For details, refer to the Semrush design system guidelines.
The app's interface mustn't display multiple scrollbars simultaneously. Users should only be presented with a single scrollbar in the app window, regardless of its content or layout.
Extra scrollbars in modal windows, tables, or individual widgets are allowed.
The double scrollbar is an issue of the scrollable app layout. To find out what kind of layout you are currently using and switch to the fixed layout, refer to the migration guide.
For details about preventing the issue, refer to the design guidelines.
The marketing materials for your app, such as screenshots, videos, and descriptions featured on the app page, must accurately represent the user interface, features, functionality, and overall user experience.
Following the Semrush design guidelines, your app's logo mustn't be positioned next to the Semrush logo, as it would be redundant.
Instead, use the app's name.