Implementation:Langfuse Langfuse Nested JSON Seed Data

Knowledge Sources	Langfuse
Domains	Seed Data, Test Data
Last Updated	2026-02-14 00:00 GMT

Overview

A large static JSON file (21,439 lines) containing a deeply nested product catalog dataset used as realistic input/output content for seeded traces and observations.

Description

This JSON file contains a mock e-commerce product catalog with extensive nesting, used by the SeederOrchestrator and DataGenerator to populate trace and observation input/output fields with realistic, complex JSON data. The file is loaded at seeding time and truncated (first 3 products only) to keep seed data at a reasonable size.

The file follows the structure of the DummyJSON products API. Each product object contains:

• Basic fields: id, title, description, category, price, discountPercentage, rating, stock
• Nested objects: dimensions (width, height, depth)
• Arrays of objects: reviews (with rating, comment, date, reviewerName, reviewerEmail)
• String arrays: tags
• Additional fields: brand, sku, weight, warrantyInformation, shippingInformation, availabilityStatus

The deeply nested structure makes it ideal for testing Langfuse's JSON rendering, metadata storage, and search capabilities across complex data shapes.

Usage

Use this file when:

• Understanding what realistic trace input/output data looks like in development.
• Testing JSON rendering in the Langfuse UI with deeply nested content.
• Modifying the seed data to include new complex data structures.

Code Reference

Source Location

• Repository: Langfuse
• File: packages/shared/scripts/seeder/utils/nested_json.json
• Lines: 1-21439

Signature

{
  "products": [
    {
      "id": 1,
      "title": "Essence Mascara Lash Princess",
      "description": "The Essence Mascara Lash Princess is a popular mascara...",
      "category": "beauty",
      "price": 9.99,
      "discountPercentage": 7.17,
      "rating": 4.94,
      "stock": 5,
      "tags": ["beauty", "mascara"],
      "brand": "Essence",
      "sku": "RCH45Q1A",
      "weight": 2,
      "dimensions": {
        "width": 23.17,
        "height": 14.43,
        "depth": 28.01
      },
      "warrantyInformation": "1 month warranty",
      "shippingInformation": "Ships in 1 month",
      "availabilityStatus": "Low Stock",
      "reviews": [
        {
          "rating": 2,
          "comment": "Very unhappy with my purchase!",
          "date": "2024-05-23T08:56:21.618Z",
          "reviewerName": "John Doe",
          "reviewerEmail": "john.doe@x.dummyjson.com"
        }
      ]
    }
  ]
}

I/O Contract

Inputs

Name	Type	Required	Description
N/A	N/A	N/A	This is a static JSON data file read by the SeederOrchestrator at seeding time.

Outputs

Name	Type	Description
products	Array of Product objects	Large array of product objects with nested dimensions, reviews, tags, and metadata

Usage Examples

// Loaded by SeederOrchestrator.loadFileContent():
import path from "path";
import { readFileSync } from "fs";

const nestedJsonPath = path.join(__dirname, "./nested_json.json");
const nestedJsonContent = JSON.parse(readFileSync(nestedJsonPath, "utf-8"));

// Truncated for seed data:
const truncatedNestedJson = {
  ...nestedJsonContent,
  products: nestedJsonContent.products?.slice(0, 3) || [],
};

// Used as trace input/output in DataGenerator.generateSyntheticTraces()