Skip to content package
html-react-parser v6.1.0 HTML to React parser.
node any 4 deps esm cjs types open source
overview readme
license MIT
deps 4
unpacked 476.0 kB
files 40
node any $ npm install html-react-parser@6.1.0n npmREADME GitHub-flavored package documentation.
downloads Across all versions, last 30 days.
5,461,137 weekly +3.7%
20,237,602 in 30 days
Oct 16 → Nov 14 hover or arrows
compatibility Runtime metadata.
keywords Tagged topics.
html-react-parser html react parser dom
versions Latest published Oct 20, 2026
maintainers Registry package owners.
install size Estimated unpacked size across 11 packages.
1.9 MB
Includes dependencies.
dependencies 4 direct dependencies.
HTML to React parser that works on both the server (Node.js) and the client (browser):
HTMLReactParser(string[, options]) copy To replace an element with another element, check out the replace option.
Example import parse from 'html-react-parser' ;
parse ( '<p>Hello, World!</p>' ); // React.createElement('p', {}, 'Hello, World!') copy
Install npm install html-react-parser --save copy yarn add html-react-parser copy <!-- HTMLReactParser depends on React -->
< script src = "https://unpkg.com/react@18/umd/react.production.min.js" ></ script >
< script src = "https://unpkg.com/html-react-parser@latest/dist/html-react-parser.min.js" ></ script >
< script >
window. HTMLReactParser ( /* string */ );
</ script > copy
Usage import parse from 'html-react-parser' ; copy Or require CommonJS module:
const parse = require ( 'html-react-parser' ).default; copy parse ( '<h1>single</h1>' ); copy parse ( '<li>Item 1</li><li>Item 2</li>' ); copy Make sure to render parsed adjacent elements under a parent element:
< ul >
{ parse ( `
<li>Item 1</li>
<li>Item 2</li>
` ) }
</ ul > copy parse ( '<body><p>Lorem ipsum</p></body>' ); copy Parse element with attributes:
parse (
'<hr id="foo" class="bar" data-attr="baz" custom="qux" style="top:42px;">' ,
); copy
replace The replace option allows you to replace an element with another element.
The replace callback's first argument is domhandler 's node:
parse ( '<br>' , {
replace (domNode) {
console. dir (domNode, { depth: null });
},
}); copy
Console output
Element {
type : 'tag' ,
parent : null,
prev : null,
next : null,
startIndex : null,
endIndex : null,
children : [],
name : 'br' ,
attribs : {}
} copy
The element is replaced if a valid React element is returned:
parse ( '<p id="replace">text</p>' , {
replace (domNode) {
if (domNode.attribs && domNode.attribs.id === 'replace' ) {
return < span > replaced </ span > ;
}
},
}); copy The second argument is the index:
parse ( '<br>' , {
replace (domNode, index) {
console. assert ( typeof index === 'number' );
},
}); copy
[!NOTE]
The index will restart at 0 when traversing the node's children so don't rely on index being a unique key (see #1259 ).
replace with TypeScript You need to check that domNode is an instance of domhandler's Element:
import { HTMLReactParserOptions, Element } from 'html-react-parser' ;
const options : HTMLReactParserOptions = {
replace (domNode) {
if (domNode instanceof Element && domNode.attribs) {
// ...
}
},
}; copy import { HTMLReactParserOptions, Element } from 'html-react-parser' ;
const options : HTMLReactParserOptions = {
replace (domNode) {
if ((domNode as Element ).attribs) {
// ...
}
},
}; copy
replace element and children Replace the element and its children:
import parse, { domToReact } from 'html-react-parser' ;
const html = `
<p id="main">
<span class="prettify">
keep me and make me pretty!
</span>
</p>
` ;
const options = {
replace ({ attribs, children }) {
if ( ! attribs) {
return ;
}
if (attribs.id === 'main' ) {
return < h1 style={ { fontSize: 42 } }>{ domToReact (children, options) }</ h1 > ;
}
if (attribs.class === 'prettify' ) {
return (
< span style={ { color: 'hotpink' } }>
{ domToReact (children, options) }
</ span >
);
}
},
};
parse (html, options); copy
HTML output
< h1 style = "font-size:42px" >
< span style = "color:hotpink" >
keep me and make me pretty!
</ span >
</ h1 > copy
replace element attributes Convert DOM attributes to React props with attributesToProps:
import parse, { attributesToProps } from 'html-react-parser' ;
const html = `
<main class="prettify" style="background: #fff; text-align: center;" />
` ;
const options = {
replace (domNode) {
if (domNode.attribs && domNode.name === 'main' ) {
const props = attributesToProps (domNode.attribs);
return < div {... props } /> ;
}
},
};
parse (html, options); copy
HTML output
< div class = "prettify" style = "background:#fff;text-align:center" ></ div > copy
replace and remove element Exclude an element from rendering by replacing it with <React.Fragment>:
parse ( '<p><br id="remove"></p>' , {
replace : ({ attribs }) => attribs?.id === 'remove' && <></> ,
}); copy
The transform option allows you to transform each element individually after it's parsed.
The transform callback's first argument is the React element:
parse ( '<br>' , {
transform (reactNode, domNode, index) {
// this will wrap every element in a div
return < div >{ reactNode }</ div > ;
},
}); copy
library The library option specifies the UI library. The default library is React .
parse ( '<br>' , {
library: require ( 'preact' ),
}); copy parse ( '<br>' , {
library: {
cloneElement : () => {
/* ... */
},
createElement : () => {
/* ... */
},
isValidElement : () => {
/* ... */
},
},
}); copy
htmlparser2
[!WARNING]
htmlparser2 options do not work on the client-side (browser); they only work on the server-side (Node.js). By overriding the options, it can break universal rendering.
parse ( '<p /><p />' , {
htmlparser2: {
xmlMode: true ,
},
}); copy
trim By default, whitespace is preserved:
parse ( '<br> \n ' ); // [React.createElement('br'), '\n'] copy But certain elements like <table> will strip out invalid whitespace:
parse ( '<table> \n </table>' ); // React.createElement('table') copy To remove whitespace, enable the trim option:
parse ( '<br> \n ' , { trim: true }); // React.createElement('br') copy However, intentional whitespace may be stripped out:
parse ( '<p> </p>' , { trim: true }); // React.createElement('p') copy
trustedTypePolicy When running in a browser, you can pass a Trusted Types policy so the parser calls trustedTypePolicy.createHTML before assigning content to innerHTML:
parse ( '<div>Hello</div>' , {
trustedTypePolicy: window.trustedTypes?. createPolicy ( 'my-policy' , {
createHTML (input) {
// apply sanitization logic here
return DOMPurify. sanitize (input);
},
}),
}); copy
Migration
v6 Changed build target from es5 to es2016.
v5 Migrated to TypeScript. CommonJS imports require the .default key:
const parse = require ( 'html-react-parser' ).default; copy If you're getting the error:
Argument of type 'ChildNode[]' is not assignable to parameter of type 'DOMNode[]'. copy domToReact (domNode.children as DOMNode [], options); copy
v4
v3 Also, it's recommended to upgrade to the latest version of TypeScript .
v2 Since v2.0.0 , Internet Explorer (IE) is no longer supported.
v1 TypeScript projects will need to update the types in v1.0.0 .
For the replace option, you may need to do the following:
import { Element } from 'domhandler/lib/node' ;
parse ( '<br class="remove">' , {
replace (domNode) {
if (domNode instanceof Element && domNode.attribs.class === 'remove' ) {
return <></> ;
}
},
}); copy Since v1.1.1 , Internet Explorer 9 (IE9) is no longer supported.
FAQ
Is this XSS safe?
Does invalid HTML get sanitized? No, this library does not sanitize HTML (see #124 , #125 , and #141 ).
Although <script> tags and their contents are rendered on the server-side, they're not evaluated on the client-side (see #98 ).
Attributes aren't getting called The reason why your HTML attributes aren't getting called is because inline event handlers (e.g., onclick) are parsed as a string rather than a function (see #73 ).
Parser throws an error
Is SSR supported? Yes, server-side rendering on Node.js is supported by this library:
Elements aren't nested correctly If your elements are nested incorrectly, check to make sure your HTML markup is valid . The HTML to DOM parsing will be affected if you're using self-closing syntax (/>) on non-void elements:
parse ( '<div /><div />' ); // returns single element instead of array of elements copy
Tags are lowercased by default. To prevent that from happening, pass the htmlparser2 option :
const options = {
htmlparser2: {
lowerCaseTags: false ,
},
};
parse ( '<CustomElement>' , options); // React.createElement('CustomElement') copy
[!WARNING]
By preserving case-sensitivity of the tags, you may get rendering warnings like:
Warning: <CustomElement> is using incorrect casing. Use PascalCase for React components, or lowercase for HTML elements. copy
TS Error: Property 'attribs' does not exist on type 'DOMNode' The TypeScript error occurs because DOMNode needs to be an instance of domhandler's Element (see migration or #199 ).
Can I enable trim for certain elements? Yes, you can enable or disable trim for certain elements using the replace option (see #205 ).
Webpack build warnings If you see the Webpack build warning:
export 'default' (imported as 'parse') was not found in 'html-react-parser' copy Then update your Webpack config to:
// webpack.config.js
module . exports = {
// ...
resolve: {
mainFields: [ 'browser' , 'main' , 'module' ],
},
}; copy
TypeScript error If you see the TypeScript error:
node_modules/htmlparser2/lib/index.d.ts:2:23 - error TS1005: ',' expected.
2 export { Parser, type ParserOptions };
~~~~~~~~~~~~~ copy
Output of benchmark run on MacBook Pro 2024:
html-to-react - Single x 1,270,990 ops/sec ±0.21% (100 runs sampled)
html-to-react - Multiple x 522,472 ops/sec ±0.64% (94 runs sampled)
html-to-react - Complex x 54,028 ops/sec ±0.82% (98 runs sampled) copy
Contributors
Code Contributors This project exists thanks to all the people who contribute. [Contribute ].
Financial Contributors Become a financial contributor and help us sustain our community. [Contribute ]
Individuals
Organizations Support this project with your organization. Your logo will show up here with a link to your website. [Contribute ]
Support
License trim