Troubleshooting guide for the missing AGC page menu or error message when clicking the menu

#appgalleryconnect #agcpermissions #rolemanagement #harmonyos

Read the original article：Troubleshooting guide for the missing AGC page menu or error message when clicking the menu

Problem Description

When operating on the AGC login page, some menus are not visible, and certain buttons are unresponsive, preventing further operations. For example:

The “Test User” menu cannot be found when inviting testers.
The “Submit for Review” button is missing when publishing an app.
Clicking certain menus causes unknown errors or no response.

Missing Submit for Review button:

The "Test User" menu is missing:

Click the menu to report an unknown error:

Clicking the "App Category" setting button does not respond:

Background Knowledge

AGC (AppGallery Connect) is the entry point for app distribution and publishing, containing multiple menu sections such as Applications, Projects, Certificates, and Personal Information. Missing menus can affect developers’ operations.

AGC menu visibility depends on the logged-in account’s role and permissions. To facilitate management, AGC provides a team account feature, where the main account can assign different roles to members.
The highest privilege role is System Administrator, followed by roles such as APP Administrator, Operations, Customer Service, Legal, etc. Different roles have different permissions:
- APP Administrator: Can publish apps and manage testing.
- Operations: Responsible for viewing app operation data.
- Legal: Handles agreement signing.
- A full list of roles and permissions can be referenced in the official documentation.
AGC also provides a menu customization feature, allowing certain menus to be shown or hidden for easier page layout management.

Troubleshooting Process

Check whether the issue is related to team account permissions.
Log in to AGC and navigate to Users & Access → Personal Information to see if the account is a team account, its role, and which projects and applications it has access to.

In this case, the logged-in account is an Account Holder (main account) with the highest privileges.

The account roles used to log in are "Operation", "Development", and "Customer Service". You can only view data, but cannot put applications on the shelf.

Check whether you have permission to customize the menu. AGC has a custom menu feature in the lower left corner. The menu appears when the pushpin to the right of the menu is selected; it does not appear when it is unselected. For example, if the "Test User" menu is unselected, the left menu bar will not appear.

When unknown errors occur, you can use the browser console to identify the specific cause:

Open the browser console (usually by pressing F12).
Go to the Network tab.
Select the interface or request that caused the error.
Check the detailed error message in the response.

Analysis Conclusion

Check whether AGC is accessed using a team account.
- If it is the main account, investigate whether custom menu settings are causing missing buttons or menus.
If it is not a team account, verify the assigned role.
- Generally, roles of APP Administrator or higher are required to publish apps or perform testing.
- Contact the main account to upgrade the role to APP Administrator or System Administrator if needed.

Solution

Log in to the AGC homepage.
Click your personal account at the top-right corner, then go to Personal Information → Role Management.
- Check if it is a team account, the assigned role, and the projects and apps accessible.
- Ensure the role is at least APP Administrator to have app management permissions, including publishing, testing, and app classification.
Use the custom menu feature at the bottom-left of AGC to check whether the relevant menu (e.g., Test User) is selected.
- If it is not selected, enable it to make the menu visible.
If an unknown error occurs, you can also check the browser log to see if the current logged-in user does not have permissions. If you log in using a team account, the logged-in role may be Development or Operations. It is recommended to contact the account holder to increase permissions, usually to at least App Administrator. Then log out of the account and log in again to try again.

Verification Result

Once the role is upgraded and menus are selected, previously missing buttons and menus become visible and functional.
Unknown errors related to insufficient permissions should no longer occur