The Substack Importer allows you to import content from a Substack newsletter into your WordPress site.

stormhill

Subsync – RSS Sync for Substack

Sync and display your Substack posts on WordPress. Perfect for newsletter publishers.

WordPress.org

<p>The Substack Importer will import content from an export file downloaded from your Substack newsletter.</p>
<p>The following content will be imported:</p>
<ul>
<li>Posts and images.</li>
<li>Podcasts.</li>
<li>Comments (only for publicly accessible posts).</li>
<li>Author information.</li>
</ul>
<p>In the future, we plan to improve the importer by:</p>
<ul>
<li>Mailing lists.</li>
<li>Enhancing the performance of processing export files with many posts and media.</li>
</ul>
<h3>Development</h3>
<p>For running unit tests and contributing to the plugin, see the <a href="https://github.com/wordpress/substack-importer#development" rel="nofollow ugc">README on GitHub</a>.</p>
<p>Tests can be run with wp-env or with any local WordPress setup paired with a Docker MySQL container. Run <code>composer install</code> first, then <code>vendor/bin/phpunit</code>.</p>
<h3>Hooks</h3>
<p>The Substack Importer provides filters and actions at key stages of the content conversion pipeline.</p>
<h4>Post-level Filters</h4>
<h3>substack_importer_post_meta</h3>
<p>Filter the post metadata loaded from the Substack API before it is used for author, comments, and other post data.</p>
<p>Parameters:<br />
* <code>$post_meta</code> (array|null) – The post metadata from the Substack API response.<br />
* <code>$post</code> (array) – The raw Substack post data from the CSV.<br />
* <code>$id</code> (int) – The Substack post ID.</p>
<h3>substack_importer_raw_content</h3>
<p>Filter the raw HTML content before Gutenberg conversion. Runs after the subtitle has been prepended (if present). Useful for cleaning up Substack-specific HTML, adding custom elements, or stripping unwanted markup.</p>
<p>Parameters:<br />
* <code>$html_body</code> (string) – The raw HTML content from the Substack export.<br />
* <code>$post</code> (array) – The raw Substack post data from the CSV.<br />
* <code>$post_meta</code> (array|null) – The post metadata from the Substack API response.</p>
<h3>substack_importer_subtitle</h3>
<p>Filter the subtitle HTML before it is prepended to the post content. Return an empty string to skip the subtitle entirely.</p>
<p>Parameters:<br />
* <code>$heading</code> (string) – The subtitle HTML (default: an h2 element).<br />
* <code>$post</code> (array) – The raw Substack post data.</p>
<h3>substack_importer_post_content_after_conversion</h3>
<p>Filter the post content after Gutenberg conversion but before it is added to the WXR. Useful for wrapping paywalled content in custom blocks (e.g., membership plugins).</p>
<p>Parameters:<br />
* <code>$post_content</code> (string) – The converted Gutenberg block content.<br />
* <code>$post</code> (array) – The original Substack post data.<br />
* <code>$post_meta</code> (array|null) – Additional post metadata from Substack API.</p>
<h3>substack_importer_post_data</h3>
<p>Filter the final post data array before it is added to the WXR.</p>
<p>Parameters:<br />
* <code>$post_data</code> (array) – The post data.<br />
* <code>$post</code> (array) – The original Substack post data.</p>
<h4>Content Conversion Filters</h4>
<h3>substack_importer_converted_node</h3>
<p>Filter the result of a single node conversion to a Gutenberg block. Allows modification of the block name and attributes. Return a null block_name to skip the node.</p>
<p>Parameters:<br />
* <code>$block_data</code> (array) – Array with ‘block_name’ and ‘block_attributes’ keys.<br />
* <code>$node</code> (DOMElement) – The converted DOM node.<br />
* <code>$node_name</code> (string) – The original HTML tag name (e.g. ‘p’, ‘div’, ‘h2’).</p>
<h3>substack_importer_image_result</h3>
<p>Filter the image node conversion result. Useful for adjusting image sizes, captions, or link destinations.</p>
<p>Parameters:<br />
* <code>$result</code> (array) – Array with ‘block_attributes’ and ‘node’ keys.<br />
* <code>$image_data</code> (array|null) – The decoded image data from the Substack data-attrs attribute.</p>
<h3>substack_importer_pre_embed_conversion</h3>
<p>Short-circuit the embed node conversion before default handling. Return a non-null array to skip the built-in switch statement entirely. Useful for handling unsupported embed types or overriding the default conversion for a specific provider.</p>
<p>Parameters:<br />
* <code>$pre_result</code> (array|null) – Return non-null to short-circuit. Expected keys: ‘node’, ‘block_attributes’, ‘block_name’.<br />
* <code>$node</code> (DOMElement) – The embed DOM node before conversion.<br />
* <code>$parent</code> (DOMElement) – The parent DOM element.<br />
* <code>$first_class</code> (string) – The CSS class identifying the embed type (e.g. ‘youtube-wrap’, ‘tweet’).</p>
<h3>substack_importer_embed_result</h3>
<p>Filter the embed node conversion result after the default conversion. Useful for modifying embed URLs, adding custom attributes, or changing how embeds are represented.</p>
<p>Parameters:<br />
* <code>$output</code> (array) – Array with ‘block_name’, ‘block_attributes’, and ‘node’ keys.<br />
* <code>$first_class</code> (string) – The CSS class identifying the embed type.</p>
<h3>substack_importer_audio_block</h3>
<p>Filter the Gutenberg audio block HTML for podcast posts.</p>
<p>Parameters:<br />
* <code>$block</code> (string) – The Gutenberg audio block HTML.<br />
* <code>$audio_url</code> (string) – The URL of the podcast audio file.</p>
<h4>Paywall Filters</h4>
<h3>substack_importer_paywall_marker_text</h3>
<p>Filter the paywall marker text that appears in the imported content.</p>
<p>Parameters:<br />
* <code>$marker_text</code> (string) – The default paywall marker text.<br />
* <code>$node</code> (DOMElement) – The paywall node being converted.<br />
* <code>$parent</code> (DOMElement) – The parent element.</p>
<h3>substack_importer_paywall_content</h3>
<p>Filter the entire paywall conversion result. Return a non-null value to override the default conversion.</p>
<p>Parameters:<br />
* <code>$result</code> (array|null) – The conversion result, null to use default.<br />
* <code>$node</code> (DOMElement) – The paywall node being converted.<br />
* <code>$parent</code> (DOMElement) – The parent element.</p>
<h4>Actions</h4>
<h3>substack_importer_before_post</h3>
<p>Fires before a single Substack post is processed and converted. Useful for setting up state or performing actions before conversion begins.</p>
<p>Parameters:<br />
* <code>$post</code> (array) – The raw Substack post data from the CSV.<br />
* <code>$post_meta</code> (array|null) – The post metadata from the Substack API response.<br />
* <code>$id</code> (int) – The Substack post ID.</p>
<h3>substack_importer_after_post</h3>
<p>Fires after a single Substack post has been converted and added to the WXR. Useful for logging, progress tracking, or performing cleanup after each post.</p>
<p>Parameters:<br />
* <code>$post_data</code> (array) – The final post data that was added to the WXR.<br />
* <code>$post</code> (array) – The raw Substack post data from the CSV.<br />
* <code>$post_meta</code> (array|null) – The post metadata from the Substack API response.<br />
* <code>$id</code> (int) – The Substack post ID.</p>


Substack Importer


This plugin worked for me, thank you for simplifying my life ♥️


Alternatives to Substack Importer

Top alternatives