DevFlow logoDevFlow

JSON to Protobuf Schema Generator — Free .proto Tool

JSON to Protobuf Schema Generator

Generate Protocol Buffer (.proto) schema definitions from JSON objects.

Free online JSON to Protobuf converter. Paste any JSON object and generate a complete .proto schema with auto-inferred field types (int32, int64, double, bool, string), nested message types for nested objects, repeated fields for arrays, and optional well-known type imports (Timestamp, Value). Supports both proto2 and proto3 syntax with configurable message name and package. Runs entirely in your browser — no data is ever sent to a server.

Keywords: json to protobuf, json to proto, json to protobuf schema, json to proto3, json to proto2, json to grpc, protobuf schema generator, proto schema generator, json to protocol buffer, generate proto from json, json to .proto file, protobuf converter online, grpc schema from json

Tags: json, protobuf, proto, schema, grpc, converter

Popular Developer Tools tools

Browse all 35 Developer Tools tools →

How to JSON to Protobuf Schema Generator Online

  1. Paste your JSON object or sample payload into the input panel on the left.

  2. Select the Protobuf syntax version — proto2 or proto3 — from the options panel.

  3. Optionally configure the top-level message name, package name, and Go package option.

  4. Click "Generate" or press ⌘↵ to produce the .proto schema.

  5. Copy the generated .proto definition with ⌘⇧C and add it to your protobuf project.

JSON to Protobuf Schema Generator Features

  • Supports both proto2 and proto3 syntax with correct field rules (optional/required vs implicit presence)

  • Automatically maps JSON types to Protobuf scalar types: int32, int64, double, bool, string, and bytes

  • Generates nested message definitions for nested JSON objects, preserving structure hierarchy

  • Maps JSON arrays to repeated fields with inferred element type

  • Handles null/missing values by using optional fields in proto3 or optional keyword in proto2

  • Configurable top-level message name — defaults to the JSON root key or "Root"

  • Package declaration and Go package option generation for multi-language projects

  • Sequential field number assignment starting from 1, following protobuf conventions

  • Runs entirely in your browser — your JSON payload is never sent to any server

  • Keyboard shortcut ⌘↵ to generate, ⌘⇧C to copy the .proto output

Frequently Asked Questions

What is Protocol Buffers (Protobuf)?
Protocol Buffers is a language-neutral, platform-neutral serialization format developed by Google. It uses a schema file (.proto) to define data structures, then compiles them into efficient binary encodings that are smaller and faster to parse than JSON or XML.
What is the difference between proto2 and proto3?
Proto3 is the current recommended version. It removes the required keyword, makes all fields optional by default, and adds support for maps and well-known types. Proto2 is still widely used in existing codebases and supports required/optional/repeated field rules explicitly.
How are JSON types mapped to Protobuf scalar types?
JSON numbers that are integers map to int32 or int64 (based on size), floating-point numbers map to double, booleans map to bool, strings map to string, and null values produce optional fields. JSON objects become nested messages and arrays become repeated fields.
Can it handle arrays of objects?
Yes. A JSON array of objects becomes a `repeated MessageType` field, and a separate message definition is generated for the object structure. Arrays of primitives become `repeated` scalar fields such as `repeated string` or `repeated int32`.
What happens with JSON null values?
In proto3, null is represented using the `google.protobuf.Value` well-known type or by making the field optional (proto3 optional). The generator uses optional fields so consumers can distinguish between a missing field and an explicitly set zero value.
How do I use the generated .proto file?
Save the .proto file to your project and compile it with `protoc` (the Protocol Buffer compiler) using the language plugin of your choice — `--go_out`, `--java_out`, `--python_out`, etc. The compiled code provides typed classes/structs for serialization and deserialization.
Is my JSON data safe to paste here?
Yes. The generator runs entirely in your browser using JavaScript — no data is transmitted to any external server. You can safely use real payload samples from your API without privacy risk.

Related Developer Tools