Skip to main content
Version: v2.x


RequestID middleware for Fiber that adds an indentifier to the response.


func New(config ...Config) fiber.Handler


Import the middleware package that is part of the Fiber web framework

import (

After you initiate your Fiber app, you can use the following possibilities:

// Initialize default config

// Or extend your config for customization
Header: "X-Custom-Header",
Generator: func() string {
return "static-id"


// Config defines the config for middleware.
type Config struct {
// Next defines a function to skip this middleware when returned true.
// Optional. Default: nil
Next func(c *fiber.Ctx) bool

// Header is the header key where to get/set the unique request ID
// Optional. Default: "X-Request-ID"
Header string

// Generator defines a function to generate the unique identifier.
// Optional. Default: utils.UUID
Generator func() string

// ContextKey defines the key used when storing the request ID in
// the locals for a specific request.
// Optional. Default: requestid
ContextKey interface{}

Default Config

The default config uses a fast UUID generator which will expose the number of requests made to the server. To conceal this value for better privacy, use the utils.UUIDv4 generator.

var ConfigDefault = Config{
Next: nil,
Header: fiber.HeaderXRequestID,
Generator: utils.UUID,
ContextKey: "requestid",