{"id":18984134,"date":"2026-08-05T03:42:12","date_gmt":"2026-08-05T03:42:12","guid":{"rendered":"https:\/\/wordpress.org\/support\/topic\/menu-priority\/"},"modified":"2026-08-05T03:42:12","modified_gmt":"2026-08-05T03:42:12","slug":"menu-priority","status":"publish","type":"topic","link":"https:\/\/wordpress.org\/support\/topic\/menu-priority\/","title":{"rendered":"Menu priority"},"content":{"rendered":"\n

Recently, a choice was made to change the Matomo’s admin menu priority to a very low weight, showing it in most cases under the Dashboard:
add_menu_page( 'Matomo Analytics', 'Matomo Analytics', self<\/em>::CAP_NOT_EXISTS, 'matomo', null, $matomo_logo_url, 2 );<\/code><\/p>\n\n\n\n

This choice is arguably bad UX: in most cases, on a Content Management System, the user’s first goal is to manage content (it’s in the name), not to browse Analytics. Having the menu so high up disrupts their experience. If not lowered altogether, this should be configurable.<\/p>\n\n\n\n

Please find below a snippet (works with “Code Snippets” plugin) for anyone interested in making the high priority optional in the meantime. This can also be adapted by the plugins’ maintainers, used as a base to actually make it optional in the plugin itself.<\/p>\n\n\n\n

<?php
\/**
 * Makes the Matomo WordPress admin-menu position configurable.
 *
 * @package Override_Matomo_Menu_Position
 *\/

defined( 'ABSPATH' ) || exit;

\/** Adds a standalone menu-position setting for Matomo. *\/
final class Override_Matomo_Menu_Position {
\tconst OPTION_NAME   = 'override_matomo_menu_after';
\tconst NONCE_ACTION  = 'override_matomo_menu_position';
\tconst FORM_ACTION   = 'override_save_matomo_menu_position';
\tconst DEFAULT_AFTER = 'index.php';

\t\/** Registers the integration after Matomo has loaded. *\/
\tpublic static function register() {
\t\tif ( ! defined( 'MATOMO_ANALYTICS_FILE' ) ) {
\t\t\treturn;
\t\t}

\t\tadd_filter( 'matomo_setting_tabs', array( __CLASS__, 'add_settings_tab' ), 20 );
\t\tadd_filter( 'custom_menu_order', '__return_true' );
\t\tadd_filter( 'menu_order', array( __CLASS__, 'reorder_menu' ), PHP_INT_MAX );
\t}

\t\/**
\t * Adds this class as a Matomo settings tab.
\t *
\t * Matomo settings tabs use objects exposing get_title() and show_settings().
\t *\/
\tpublic static function add_settings_tab( $tabs ) {
\t\t$tabs['menu-position'] = new self();

\t\treturn $tabs;
\t}

\t\/** Returns the Matomo settings-tab title. *\/
\tpublic function get_title() {
\t\treturn 'Menu position';
\t}

\t\/** Renders and processes the settings tab. *\/
\tpublic function show_settings() {
\t\tif ( ! current_user_can( 'superuser_matomo' ) ) { \/\/ phpcs:ignore WordPress.WP.Capabilities.Unknown
\t\t\twp_die( esc_html__( 'You are not allowed to manage Matomo settings.', 'matomo' ) );
\t\t}

\t\t$was_updated = false;

\t\tif (
\t\t\tisset( $_POST['override_matomo_menu_action'] )
\t\t\t&& self::FORM_ACTION === sanitize_key( wp_unslash( $_POST['override_matomo_menu_action'] ) )
\t\t) {
\t\t\tcheck_admin_referer( self::NONCE_ACTION );

\t\t\t$requested_position = isset( $_POST[ self::OPTION_NAME ] )
\t\t\t\t? sanitize_text_field( wp_unslash( $_POST[ self::OPTION_NAME ] ) )
\t\t\t\t: self::DEFAULT_AFTER;

\t\t\t$positions = self::get_positions();

\t\t\tif ( ! array_key_exists( $requested_position, $positions ) ) {
\t\t\t\t$requested_position = self::DEFAULT_AFTER;
\t\t\t}

\t\t\tself::update_position( $requested_position );
\t\t\t$was_updated = true;
\t\t}

\t\t$current_position = self::get_position();
\t\t$positions        = self::get_positions();

\t\tif ( $was_updated ) {
\t\t\t?>
\t\t\t<div class=\"matomo-notice notice notice-success is-dismissible\">
\t\t\t\t<p><?php esc_html_e( 'Menu position updated.', 'matomo' ); ?><\/p>
\t\t\t<\/div>
\t\t\t<?php
\t\t}
\t\t?>

\t\t<form method=\"post\">
\t\t\t<?php wp_nonce_field( self::NONCE_ACTION ); ?>

\t\t\t<input
\t\t\t\ttype=\"hidden\"
\t\t\t\tname=\"override_matomo_menu_action\"
\t\t\t\tvalue=\"<?php echo esc_attr( self::FORM_ACTION ); ?>\"
\t\t\t\/>

\t\t\t<table class=\"matomo-tracking-form widefat\">
\t\t\t\t<tbody>
\t\t\t\t\t<tr>
\t\t\t\t\t\t<th width=\"20%\" scope=\"row\">
\t\t\t\t\t\t\t<label for=\"<?php echo esc_attr( self::OPTION_NAME ); ?>\">
\t\t\t\t\t\t\t\t<?php esc_html_e( 'Show Matomo Analytics after', 'matomo' ); ?>:
\t\t\t\t\t\t\t<\/label>
\t\t\t\t\t\t<\/th>

\t\t\t\t\t\t<td>
\t\t\t\t\t\t\t<select
\t\t\t\t\t\t\t\tid=\"<?php echo esc_attr( self::OPTION_NAME ); ?>\"
\t\t\t\t\t\t\t\tname=\"<?php echo esc_attr( self::OPTION_NAME ); ?>\"
\t\t\t\t\t\t\t>
\t\t\t\t\t\t\t\t<?php foreach ( $positions as $menu_slug => $label ) { ?>
\t\t\t\t\t\t\t\t\t<option
\t\t\t\t\t\t\t\t\t\tvalue=\"<?php echo esc_attr( $menu_slug ); ?>\"
\t\t\t\t\t\t\t\t\t\t<?php selected( $current_position, $menu_slug ); ?>
\t\t\t\t\t\t\t\t\t>
\t\t\t\t\t\t\t\t\t\t<?php echo esc_html( $label ); ?>
\t\t\t\t\t\t\t\t\t<\/option>
\t\t\t\t\t\t\t\t<?php } ?>
\t\t\t\t\t\t\t<\/select>
\t\t\t\t\t\t<\/td>

\t\t\t\t\t\t<td width=\"50%\">
\t\t\t\t\t\t\t<?php esc_html_e( 'Choose which WordPress admin-menu item Matomo Analytics should follow.', 'matomo' ); ?>
\t\t\t\t\t\t<\/td>
\t\t\t\t\t<\/tr>

\t\t\t\t\t<tr>
\t\t\t\t\t\t<td colspan=\"3\">
\t\t\t\t\t\t\t<p class=\"submit\">
\t\t\t\t\t\t\t\t<input
\t\t\t\t\t\t\t\t\ttype=\"submit\"
\t\t\t\t\t\t\t\t\tclass=\"button-primary\"
\t\t\t\t\t\t\t\t\tvalue=\"<?php esc_attr_e( 'Save Changes', 'matomo' ); ?>\"
\t\t\t\t\t\t\t\t\/>
\t\t\t\t\t\t\t<\/p>
\t\t\t\t\t\t<\/td>
\t\t\t\t\t<\/tr>
\t\t\t\t<\/tbody>
\t\t\t<\/table>
\t\t<\/form>
\t\t<?php
\t}

\t\/** Moves Matomo immediately after the configured menu item. *\/
\tpublic static function reorder_menu( $menu_order ) {
\t\tif ( ! is_array( $menu_order ) ) {
\t\t\treturn $menu_order;
\t\t}

\t\t$matomo_index = array_search( 'matomo', $menu_order, true );

\t\tif ( false === $matomo_index ) {
\t\t\treturn $menu_order;
\t\t}

\t\tunset( $menu_order[ $matomo_index ] );
\t\t$menu_order = array_values( $menu_order );

\t\t$after_slug = self::get_position();

\t\tif ( '__bottom__' === $after_slug ) {
\t\t\t$menu_order[] = 'matomo';

\t\t\treturn $menu_order;
\t\t}

\t\t$after_index = array_search( $after_slug, $menu_order, true );

\t\tif ( false === $after_index ) {
\t\t\t$after_index = array_search( self::DEFAULT_AFTER, $menu_order, true );
\t\t}

\t\tif ( false === $after_index ) {
\t\t\tarray_unshift( $menu_order, 'matomo' );

\t\t\treturn $menu_order;
\t\t}

\t\tarray_splice( $menu_order, $after_index + 1, 0, array( 'matomo' ) );

\t\treturn $menu_order;
\t}

\t\/** Returns the supported placement targets. *\/
\tprivate static function get_positions() {
\t\treturn array(
\t\t\t'index.php'               => 'Dashboard',
\t\t\t'edit.php'                => 'Posts',
\t\t\t'upload.php'              => 'Media',
\t\t\t'edit.php?post_type=page' => 'Pages',
\t\t\t'edit-comments.php'       => 'Comments',
\t\t\t'themes.php'              => 'Appearance',
\t\t\t'plugins.php'             => 'Plugins',
\t\t\t'users.php'               => 'Users',
\t\t\t'tools.php'               => 'Tools',
\t\t\t'options-general.php'     => 'Settings',
\t\t\t'__bottom__'              => 'Bottom of the menu',
\t\t);
\t}

\t\/** Gets the saved position for the current administration context. *\/
\tprivate static function get_position() {
\t\t$position = is_network_admin()
\t\t\t? get_site_option( self::OPTION_NAME, self::DEFAULT_AFTER )
\t\t\t: get_option( self::OPTION_NAME, self::DEFAULT_AFTER );

\t\treturn array_key_exists( $position, self::get_positions() )
\t\t\t? $position
\t\t\t: self::DEFAULT_AFTER;
\t}

\t\/** Saves the position for the current administration context. *\/
\tprivate static function update_position( $position ) {
\t\tif ( is_network_admin() ) {
\t\t\tupdate_site_option( self::OPTION_NAME, $position );
\t\t\treturn;
\t\t}

\t\tupdate_option( self::OPTION_NAME, $position, false );
\t}
}

add_action( 'init', array( 'Override_Matomo_Menu_Position', 'register' ) );<\/code><\/pre>\n","protected":false},"template":"","class_list":["post-18984134","topic","type-topic","status-publish","hentry"],"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/support\/wp-json\/wp\/v2\/topic\/18984134","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/support\/wp-json\/wp\/v2\/topic"}],"about":[{"href":"https:\/\/wordpress.org\/support\/wp-json\/wp\/v2\/types\/topic"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.org\/support\/wp-json\/wp\/v2\/topic\/18984134\/revisions"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/support\/wp-json\/wp\/v2\/media?parent=18984134"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}