<!-- LLM_VERSION_INFO
FORMAT: text/markdown
CONTENT_TYPE: article
ORIGINAL_URL: https://jam.dev/docs/product-features/dev-tools/jam.metadata
ALTERNATE_VERSION: docs/product-features/dev-tools/jam-metadata.html (text/html)
EXTRACTION_DATE: 2026-04-17T03:51:02.034Z

This is the markdown version with text-only content (images converted to alt-text).
For rich formatting with images, request the HTML version at: docs/product-features/dev-tools/jam-metadata.html
-->

With one function call, `jam.metadata()`, you can ensure that every Jam submitted from your website includes the metadata you need to debug the bug. Custom logs work on all types of Jams, including requested Jams from [Recording Links](/content/docs/request-a-jam/recording-links/index.html), Jam for Customer Support and the Jam browser extension.

You can log anything in custom logs: simple static values like `userID`, `teamID` to any data like redux or react state. Whatever you need to debug, just add it to custom logs so it's always there for you in any ticket.

## Getting Started

1. First, install the Jam SDK into your project:

```
   npm install '@jam.dev/sdk'
   # or:
   yarn add '@jam.dev/sdk'
   ```

2. Once the script is included, you can start using the `jam.metadata` function to include debug information with every Jam a user files on your site:

```javascript
   // In the root of your app, the place where
   // you would initialize your app's stores and
   // render React onto your root element
   import { jam } from "@jam.dev/sdk";

// We call the jam.metadata function once.
   // The function we pass into it is called whenever
   // a Jam is captured, so the data inside is always
   // live and never stale.

jam.metadata(() => {
       return {
           userId: 5492,
           teamId: 'd3b59ce8-95f1-410c-bb5e-9dc598599336',
           timeSincePageLoad: performance.now(),
           a: { nested: ['object', 'or', 'array'] }
           // and any other debug data you'd need
       };
   });
   ```

3. Now, your metadata will be shown inside every Jam filed from your site!

## What data can you include in custom logs?

Beyond static values and local variables, you can also pass in:

- State from your app stores (for example: user ID, team ID, the last 5 items in your user's checkout cart, which feature flags are enabled, etc.)
- Values from localStorage
- Whatever data you need to debug your bugs!

## Test it out live, Right now!

To see this live, try going to our [example site](https://jamdotdev.github.io/sdk/todo-mobx-example/index.html) and creating a Jam! This example site already has custom logs integrated, so as soon as you capture any kind of Jam, we'll include up-to-date debugging info.

Your Jam should include metadata that looks like the following:

Your site's metadata, included! Try creating more todo items to see how todoItemCount changes.

The live code is [here](https://github.com/Strawberry-Jam-Manufacturers/sdk/tree/main/docs/todo-mobx-example), and the `jam.metadata()` call is [here](https://github.com/Strawberry-Jam-Manufacturers/sdk/blob/main/docs/todo-mobx-example/src/index.tsx), for your reference. This demo shows a realistic example of how to include data from a store. In this case, we use MobX for state management, but you can pull from Redux, Zustand, or any other store you prefer.

## When is metadata captured?

Metadata is captured when a bug reporter decides to create a Jam.

## Limits, Constraints, and Errors

When calling `jam.metadata()`, keep in mind that the returned metadata object must be:

1. An `Object` instance (for example, `{ a: 1, b: 2}`, and not `window`, which is a `Window` instance)
2. Under 10kb in size, when serialized.
3. Serializable. If `JSON.stringify` can't stringify it, we can't store it!

If your app throws an error, or the above conditions aren't met, Jam will log in your browser's live console, and display an error when the Jam is captured.