Skip to content
Technology transformation expertise firm · ARDIANE Group Innovate, secure, succeed

Glossary

Internal developer portal: definition of the in-house developer portal

Domain

Cloud and platforms

In brief

An internal developer portal is the web interface where an organisation's development teams find the catalogue of software components, their owners and their documentation, create projects from templates and access the capabilities of the internal platform. The expression is one of common usage: the CNCF "Platforms" white paper speaks of web portals.

Page contents

Definition of the internal developer portal

Which software services already exist, who is answerable for them, how do you create a new one? The internal developer portal (portail développeur interne in French) is the web interface that brings these answers together for an organisation’s development teams. It gathers a catalogue of software components, project templates, technical documentation and access to the capabilities of the internal platform.

The expression belongs to the vocabulary of projects and tool vendors. The “Platforms” white paper from the CNCF TAG App Delivery (tag-app-delivery.cncf.io) does not use it. It speaks of “Web portals” and makes them one of the families of capabilities of a platform, responsible for publishing documentation, service catalogues and project templates.

Two tool documentations, consulted on 12 November 2026, speak of a developer portal. The Backstage documentation, a CNCF project, describes “an open source framework for building developer portals”. The documentation of Port, a vendor’s product, sees in the internal developer portal “a central interface” where developers find services, consult engineering information and launch self-service actions.

Portal, platform, ITSM catalogue, API portal: not to be confused

The internal developer platform, defined in our entry on platform engineering, is the set of capabilities offered on a self-service basis. The portal is one interface to it: the CNCF white paper also cites APIs, the command line and development environments. The two expressions share the acronym IDP.

In IT service management (ITSM), common usage calls service catalogue the list of what an IT department offers its users. The catalogue of a developer portal lists software components and the teams answerable for them.

The API portal, presented in the entry on API management, is aimed at those who consume APIs, third parties included.

The golden path is a recommended route, which the portal makes it possible to find.

Catalogue, templates, documentation, self-service

The Backstage documentation details three core functions, which plugins complement.

  • The software catalogue tracks the ownership and metadata of the organisation’s software: services, websites, libraries, data pipelines. It is fed by YAML files stored with the code. Its stated aim: that every piece of software and its owner can be found. The need grows with the number of components, as in a microservices architecture.
  • Templates are used to create new projects that comply with the organisation’s practices.
  • Technical documentation is managed like code (“docs like code”).

To these is added self-service, which Port calls “self-service actions”. The CNCF white paper gives an example: requesting a database through a form, then receiving its address and credentials.

At a carrier: finding the owner of a service

Suppose a carrier whose teams maintain services for parcel tracking, delivery round planning and invoicing. A developer needs to call the delivery rounds service. She searches for it in the portal catalogue, reads the name of the owning team there and opens the interface documentation.

Later, this team is split, and nobody corrects the service’s metadata file. The catalogue then displays a team that no longer exists.

What a portal does not solve

The portal is an interface. If no automated capability responds behind a form, the request is handled by hand.

The catalogue is only as good as the metadata kept by the teams.

Nor is a portal a prerequisite. According to the CNCF white paper, a very simple platform can come down to a wiki page pointing to procedures. Finally, a portal is itself software to be run and maintained.

Our page on DevOps and platform engineering specifies at what point in a platform approach a portal finds its place.

FAQ

Frequently asked questions

Another question? Ask us

What is an internal developer portal for?

An internal developer portal serves as an entry point for an organisation's development teams: there they find existing software components, their owners and their documentation, and create new projects from templates. The "Platforms" white paper from the CNCF TAG App Delivery entrusts web portals with publishing documentation, service catalogues and project templates. According to this text, a portal form also makes it possible to request a platform capability, a database for example.

What is the difference between an internal developer portal and an internal developer platform?

The internal developer platform is the set of capabilities that a platform team offers on a self-service basis to development teams: environments, delivery pipelines, databases. The internal developer portal is one of the interfaces that give access to it. The CNCF "Platforms" white paper cites portals alongside graphical interfaces, APIs, the command line and development environments.

Is Backstage an internal developer portal?

Backstage presents itself, in its documentation, as "an open source framework for building developer portals", built around a centralised software catalogue. Backstage is therefore used to build an internal developer portal, which the organisation assembles itself. According to the project page on the CNCF website, consulted on 12 November 2026, Backstage was accepted by the CNCF on 8 September 2020 and has been at the "Incubating" maturity level since 15 March 2022.

A project to bring to completion?

A first conversation is enough to understand your challenge, identify the right people and tell you frankly what we can bring.