Custom Metadata

Inject custom metadata in your issues to help developers better understand feedback

Joe Scanlon avatar
Written by Joe Scanlon
Updated over a week ago

Introduction to Custom Metadata is designed to automatically gather essential metadata related to reported issues, such as the page URL, browser details, console logs, and network requests. However, for a more comprehensive understanding of feedback, our platform also offers the ability to integrate custom metadata through the snippet code. This feature is invaluable for developers, providing additional context about the application's current state and aiding in efficient debugging.

Note: You may also like to identify your reporters automatically.

Types of Custom Metadata

We support various custom metadata types to cater to diverse application needs.

  • number

  • boolean

  • strings

  • array

  • objects

Methods to Implement Custom Metadata

Method 1: Embedding Custom Metadata in the JavaScript snippet

To seamlessly integrate custom metadata during widget loading, include a customData object in your widget configuration.

window.markerConfig = {
project: "<PROJECT ID>",
customData: {
storeId: 123,
storeName: 'Organic Fruits',

Example: Suppose you wish to incorporate the user ID of an authenticated user and your application's version into's custom metadata. Let's say that the JavaScript variables user_ID and app_ver represent the user and application version respectively, your JavaScript snippet would look like:

window.markerConfig = {
project: '650d9785e9819c0f22aabbcc', //place your proeject id here
source: 'snippet',

// Collect custom information
customData: {
userId: user_ID,
appVersion: app_ver,

When anyone reports feedback on my website, the custom metadata will appear on your feedback page as shown below:

Additionally, if you utilize any of our third-party integrations, the custom metadata will be seamlessly integrated, as demonstrated in the Jira example here:

Method 2. Dynamic Custom Metadata Assignment with Marker.setCustomData() and the SDK

For dynamic applications, you may need to update custom metadata on the fly. Use the Marker.setCustomData() within our SDK to achieve this.

product: 'Banana',
available: true,
price: 1.23,
stock: 131,
brands: [
'The Organic Corp',
'ACME Fruits Inc',


userId: newUserID,
appVersion: newAppVersion,

Note: only member and admin roles can see the injected metadata in

Did this answer your question?