---
title: Esbuild plugin
description: Install and configure the Coralogix Esbuild plugin, which emits the metadata asset the RUM SDK uses to attribute errors to a micro frontend.
url: https://coralogix.com/docs/user-guides/rum/sdk-installation/javascript/bundler-plugins/esbuild/
product: rum
feature: Source Mapping
feature_id: source-mapping
feature_identifier: rum/source-mapping
last_updated: '2026-08-21'
---

# Coralogix Esbuild plugin

[![npm version](https://img.shields.io/npm/v/@coralogix/esbuild-plugin)](https://www.npmjs.com/package/@coralogix/esbuild-plugin) [![npm dm](https://img.shields.io/npm/dm/@coralogix/esbuild-plugin)](https://www.npmjs.com/package/@coralogix/esbuild-plugin) [![npm dt](https://img.shields.io/npm/dt/@coralogix/esbuild-plugin)](https://www.npmjs.com/package/@coralogix/esbuild-plugin)

> An Esbuild plugin that creates metadata asset for support micro frontend in Coralogix.

## Installation

```
npm i -D @coralogix/esbuild-plugin
```

## Example

```
// esbuild.config.js

const esbuild = require('esbuild');

const { coralogixEsbuildPlugin } = require("@coralogix/esbuild-plugin");



await esbuild.build({

  entryPoints: ['app.js'],

  bundle: true,

  outfile: 'out.js',

  plugins: [

    coralogixEsbuildPlugin({

        app:'test-app',

        version:'1.0.0'

      })

  ],

})
```

## Options

| Option      | Type   | Description                                                                                                                             |
| ----------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| `app`       | string | Name of the micro frontend. Coralogix labels errors from this bundle with it.                                                           |
| `version`   | string | Version of the micro frontend, labelled alongside `app`.                                                                                |
| `outputDir` | string | Optional. Directory to write `cx-metadata.json` into, relative to the build output directory. Defaults to the root of the build output. |

Set `outputDir` when the bundle is served from somewhere other than the root of the output directory, so the RUM SDK finds the metadata next to the assets it describes.