Read our latest article: "devrel.directory is back"

devrel.directory

Definition of Developer Relations

A working definition of DevRel, what it is not, where the function should report, and how the definition shifts with company stage and product type.

A working definition

Developer Relations is the function that owns the relationship between a company and the developers who build with its product. The relationship runs in both directions. Outward, DevRel earns developers' trust by removing friction between them and the product: documentation, onboarding, examples, support, community. Inward, it represents developers' needs to product, engineering, and leadership with enough authority to change what gets built. The academic framing agrees: Oliveira et al. [2021] describe DevRel as a strategic function that builds and maintains relationships with developer communities, partner companies, and other key stakeholders through programs that engage and support developers. The practitioner shorthand is shorter: help developers succeed with your product, and make sure your company hears what they need.

The litmus test is the direction of information flow. A team that only pushes messages out is doing developer marketing. The "relations" in the name means the channel carries feedback in - or it is not DevRel.

Trust is the working capital of the whole function. Developers extend it slowly, verify it constantly, and withdraw it permanently when they catch a function optimizing for the company at their expense. Every position in the rest of this page follows from protecting that capital.

What DevRel is not

The definition gets muddier every year because adjacent functions borrow the label. Four boundaries are worth defending explicitly.

Not marketing with a hoodie

Developer marketing is a legitimate discipline: campaigns, launches, paid reach, conversion. The mistake is dressing it as DevRel - putting a technical-looking person on stage to deliver what is structurally a pitch. Developers detect the switch immediately, and the cost lands on the whole function: once an audience decides your advocates are salespeople, no future talk, post, or forum answer from your company is read at face value. The two disciplines can and should coexist, but they need different names, different metrics, and usually different people. Marketing optimizes for reach and conversion this quarter. DevRel optimizes for developer success and trust across years. Measure one by the standards of the other and you break it.

Not sales

A DevRel team with a quota stops being believed, because its usefulness rests on the freedom to say "our product is the wrong fit for your use case." A salesperson cannot say that sentence; an advocate must be able to. Pipeline often follows good DevRel work - developers who succeed become champions inside buying decisions - but pipeline can be a consequence of the work, never its assignment. The moment an advocate's compensation depends on a deal closing, every technical recommendation they make is compromised, including the honest ones.

Not just conference talks

Talks are the most visible sliver of the job, which is exactly why they distort the picture. The bulk of real DevRel work is unglamorous: rewriting the quickstart, answering the same question in the forum for the fortieth time, synthesizing feedback into filed issues, fixing the onboarding snag that stalls every new integration. A team measured on talks delivered optimizes for airports, and a team hired for stage presence alone cannot do the desk work that actually moves adoption. Treat speaking as one activity among many that must earn its place against a goal - the full activity map lives on the DevRel activities page.

Not the support queue

DevRel answers developer questions, but it is not the support organization. The distinction is what happens after the answer: support resolves the ticket, while DevRel asks why the question keeps arriving and fixes the doc, the error message, or the API design that generates it. A DevRel team that becomes the de-facto support queue loses the time for exactly that second step, which is where its leverage lives. Route the volume to support, and keep DevRel on the patterns.

One more boundary: DevRel is not a single job. Advocacy, documentation, community, developer experience engineering, and developer marketing are distinct roles with distinct skills, and conflating them produces bad hires in both directions. The role taxonomy has its own page: roles and responsibilities.

Where DevRel should report

The honest answer: the reporting line matters less than the metrics it imposes, because metrics determine behavior. But since the box on the org chart usually decides the metrics, the box is worth arguing about.

The default position for a developer-first company: DevRel should report into Product. The inward half of the definition - carrying developer needs into roadmap decisions - requires a seat where roadmaps are actually decided. A DevRel team inside Product can file the feedback where it becomes work; a DevRel team three reporting layers from product decisions can only write memos.

Engineering is a strong second home, and sometimes the better one when the work is docs-heavy and DX-heavy: SDK quality, API design feedback, reference documentation. The trade-off is that engineering leadership rarely defends community and content work when headcount tightens.

Marketing can work, under two conditions that are frequently not met: leadership must be fluent in developer-audience norms, and the team's goals must genuinely be awareness rather than leads. The predictable failure mode is inheritance - a DevRel team inside marketing inherits MQL targets and campaign calendars within a few quarters, drifts into lead generation, and burns the trust the function exists to build. If your marketing organization can hold the line on that, the placement is fine; most cannot.

Sales is not a home for DevRel under any conditions, for the reasons in the previous section.

Three rules that hold regardless of the box:

  1. The reporting line must never force lead or pipeline metrics onto the team.
  2. DevRel needs a named executive sponsor who can defend multi-quarter payoffs, because most of the work compounds slowly.
  3. The goals must be written down and tied to business outcomes - the DevRel strategy page covers how.

If you take one position from this page: never let DevRel report into an organization that is measured on this quarter's revenue. The function's entire value is built on developers believing it is not trying to close them.

The definition shifts with company stage

The one-paragraph definition holds everywhere, but what it means in practice changes with the company around it. Hiring against the wrong stage's definition is one of the most common ways DevRel programs fail.

Before product-market fit

Here DevRel is a feedback loop with a person attached. The job is to get the first hundred developers to a working result and report back, in specific detail, why everyone else failed. The right hire is founder-adjacent: technical enough to fix docs and examples directly, close enough to the product team to change the product itself. Community programs, conference circuits, and content calendars are premature at this stage - there is no community yet, and the product is still changing under every piece of content you write.

Growth stage

Here DevRel is friction removal at scale. The individual attention that worked for the first hundred developers cannot reach the next ten thousand, so the work shifts to leverage: documentation coverage, self-serve onboarding, a community where peers answer each other, content that answers the questions the team used to answer by hand. This is the stage where developer personas and a written strategy stop being optional, because the team can no longer hold every developer in its head. It is also the stage where community building becomes a genuine program rather than a founder replying fast.

Platform and enterprise scale

Here DevRel is ecosystem stewardship. The audience is no longer only your direct users - it is partner developers, agencies, marketplace builders, and companies whose businesses depend on your platform's stability. The work adds new surfaces: partner enablement, deprecation policy, versioning discipline, and defending the ecosystem's long-term health against the company's short-term incentives. At this stage the inward half of the definition is the harder half, because a platform that breaks its developers' trust at scale rarely gets it back.

The definition shifts with product type

Lewko and Parton [2021] draw the most useful product-type distinction: developer-first versus developer-plus.

In a developer-first company, the developer is both the user and the effective buyer - API companies and developer tools. Here DevRel sits close to the core product function, because docs, onboarding, and DX are not supporting material; they are most of the product surface a customer ever touches. Underinvesting in DevRel at a developer-first company is underinvesting in the product.

In a developer-plus company, the product is bought and used by a broader audience, and developers extend it - platforms with app stores, plugin ecosystems, and integration marketplaces. Here DevRel is an ecosystem growth function: its job is to make building on the platform attractive and profitable enough that third parties keep doing it. The metrics shift accordingly, from direct adoption toward ecosystem health - active integrations, partner-built value, marketplace quality.

Open-source companies are a third case that cuts across both. The community is simultaneously user base, contributor base, and free-tier audience, and DevRel manages the boundary between the open project and the commercial product. The definition gains a stewardship duty toward people who will never pay, because their contributions and credibility are what make the commercial side worth paying for.

The definition in the AI era

The mission does not change when the first reader of your docs is a model instead of a person: build trust, remove friction, carry feedback inward. What changes is where the friction lives, because a growing share of first contact with developer products now happens through AI agents acting on a developer's behalf. That shifts documentation and machine-readable surfaces further up the priority list and adds a new, stricter test subject for developer experience work. The full argument lives in agents are your new developers.


Sources & References:

On this page