Azure API Management Developer Portal - Products Not Visible

Ashish Thorat 1 Reputation point

I am facing an issue with Azure API Management (APIM) Developer Portal where products are not visible to a user (me) even though the user appears to have the required permissions.

Current Configuration

APIM instance is running on the Developer tier.

Multiple Products have been created.

Products are marked as Published.

APIs have been added to the Products.

Product visibility/access is configured for:

  • Administrators
  • Developers
  • The user is registered and can successfully log in to the Developer Portal.

The email address used for login has been verified and is correct.

The user is a member of the built-in Developers group in APIM.

Issue

After logging into the Developer Portal:

The user can access the portal successfully.

The Products page does not show the Products that should be visible to the Developers group.

As a result, the APIs associated with those Products are also not visible.

Other Products in the APIM instance do contain APIs and appear to be configured correctly.

Validation Performed

I have already verified the following:

Products are Published.

APIs are associated with the Products.

Developers group is explicitly assigned access to the Products.

The logged-in user is a member of the Developers group.

The login email is correct.

  • The Developer Portal has been published.
  • Republishing tried after making any changes in groups and products.

Questions

Are there any additional settings that control Product visibility in the Developer Portal beyond Product publication and group assignment?

Is there a way to verify which APIM groups are actually being applied to the logged-in portal user?

Could there be a synchronization or caching issue between APIM and the Developer Portal?

Are there any known issues where users in the Developers group cannot see Products even when access has been granted?

What additional troubleshooting steps would you recommend to determine why Products are not appearing in the Developer Portal?

Any guidance would be appreciated.

  1. Rakesh Mishra 9,695 Reputation points • Microsoft External Staff • Moderator

    Hi Ashish,

    Thank you for providing the clear details regarding your configuration. When products fail to appear in the Developer Portal despite correct group assignments and publication status, it is often due to a disconnect between the APIM backend state and the portal’s content editor configuration.

    Beyond the standard checks, please consider these specific areas:

    1. Verify Widget Configuration in the Developer Portal: The Developer Portal is a CMS-driven site. Even if a product is "Published," the Product List widget on your homepage or Products page might be configured with a filter that unintentionally excludes your products.

    • Navigate to your APIM instance → Developer portal → Portal overview → Open the portal.
    • In the Admin panel, go to the Products page.
    • Click on the Product List widget to open its settings.
    • Ensure that the "Show products" settings are not restricted by tags or specific categories that your products lack.

    2. Managed Identity and Portal Synchronization: If your APIM instance is recently configured or migrated, the synchronization between the backend and the portal can sometimes hang. While you mentioned "republishing," ensure you are performing a "Publish" operation from the portal admin console, not just the Azure portal "Save."

    • In the Developer Portal admin console, click the Publish button in the top menu to push all pending changes to the live site.

    3. Official Documentation Reference: As per the official Microsoft documentation on the Developer Portal, visibility is managed via the Groups associated with a product. Ensure the product configuration in the Azure portal reflects this:

    "Products are grouped into collections. A product can contain one or more APIs. Products can be configured to be visible to specific groups of developers."

    If you continue to face this, please verify the "Product visibility" at the API level as well, as adding an API to a product does not automatically make the product visible if the product itself hasn't been assigned to the group in the "Access" tab of the product configuration.

    Please let me know in comments if it helps or need any further assistance on this.

    Note: This response is drafted with the help of AI systems.

  2. Ashish Thorat 1 Reputation point

    Based on @Rakesh Mishra 's inputs, i checked the Product List widget page of Admin panel and I was able to see all the Products listed on it, but they were not visible on the actual developer portal after my login.
    As per the other solution pointed out by @TP Checking Require Subscription box, showed up the products.

Sign in to comment

Answer accepted by question author

TP 157.5K Reputation points • Volunteer Moderator

Hi Ashish,

Are these Open products (Requires subscription unchecked)? Open products are only shown to Administrators. Below is excerpt from documentation:

Note

Open products aren't listed in the developer portal for developers to learn about or subscribe to. They're visible only to the Administrators group. You'll need to use another mechanism to inform developers about APIs that can be accessed without a subscription key.

If you need them to show up in Developer portal to Developers group then you would need to edit Properties and check Requires subscription.

👁 User's image

Please click Accept Answer and upvote if the above was helpful.

Thanks.

-TP

  1. Ashish Thorat 1 Reputation point

    This was the issue all along.
    Couldn't find this limitation easily in documentation.

    Found your mentioned comment in below page:
    https://learn.microsoft.com/en-us/azure/api-management/api-management-subscriptions#enable-or-disable-subscription-requirement-for-api-or-product-access

    If we have JWT token verification in our API's, we may not use the subscription key.
    So blocking its display just because Subscription key is not enabled is odd.

    And what is even odd is, I could see all the products on - Product List widget page of Admin panel.

    We loose the benefit of entire Product feature on Developer portal because of this limitation/feature.

    Thanks a lot for your quick help.

Sign in to comment

0 additional answers

Sign in to answer

Your answer