{"id":9449,"date":"2024-02-06T16:13:22","date_gmt":"2024-02-06T14:13:22","guid":{"rendered":"https:\/\/creativethemes.com\/blocksy\/?post_type=documentation&#038;p=9449"},"modified":"2026-10-08T14:27:09","modified_gmt":"2026-10-08T11:27:09","slug":"newsletter","status":"publish","type":"documentation","link":"https:\/\/creativethemes.com\/blocksy\/docs\/theme-blocks\/newsletter\/","title":{"rendered":"Newsletter"},"content":{"rendered":"\n<div class=\"wp-block-group is-layout-constrained wp-block-group-is-layout-constrained\">\n<figure class=\"wp-block-video\"><video height=\"2056\" style=\"aspect-ratio: 3456 \/ 2056;\" width=\"3456\" autoplay loop muted preload=\"auto\" src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2024\/02\/Screen-Recording-2024-02-27-at-12.53.09.mov\" playsinline><\/video><figcaption class=\"wp-element-caption\">The Newsletter block in action.<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The <strong>Newsletter<\/strong> block lets you place a subscription form directly inside layouts created with the WordPress block editor. It connects to Blocksy&#8217;s <a href=\"https:\/\/creativethemes.com\/blocksy\/docs\/extensions\/newsletter-subscribe\/\" target=\"_blank\" rel=\"noreferrer noopener\"><strong>Newsletter Subscribe<\/strong><\/a> extension and sends new subscriptions to the configured email marketing provider.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The block can be inserted into posts, pages, Custom Post Types, Content Blocks and other areas where the WordPress block editor is available, with independent controls for the target list, form layout and fields.<\/p>\n\n\n\n<div class=\"wp-block-group has-palette-color-8-color has-palette-color-1-background-color has-text-color has-background is-layout-constrained wp-block-group-is-layout-constrained\">\n<p class=\"is-style-info coblocks-alert-paragraph wp-block-paragraph\"><strong>Newsletter Subscribe required<\/strong><br>Before using the Newsletter block, enable and configure the <strong>Newsletter Subscribe<\/strong> extension under <strong>WordPress Dashboard \u2192 Blocksy \u2192 Extensions<\/strong>. The providers available to the block depend on the extension and your Blocksy plan.<\/p>\n<\/div>\n<\/div>\n\n\n\n<div class=\"wp-block-group is-layout-constrained wp-block-group-is-layout-constrained\">\n<h2 class=\"wp-block-heading\">Getting Started<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Once the Newsletter Subscribe extension has been configured:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open the post, page or other layout where you want to display the subscription form.<\/li>\n\n\n\n<li>Open the WordPress block inserter and search for <strong>Newsletter<\/strong>.<\/li>\n\n\n\n<li>Add the block to your layout.<\/li>\n\n\n\n<li>Use the block settings to choose the destination list and configure the form&#8217;s fields and presentation.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">The provider connection itself remains managed by the Newsletter Subscribe extension, while each Newsletter block can have its own form configuration.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-group is-layout-constrained wp-block-group-is-layout-constrained\">\n<h2 class=\"wp-block-heading\">Granular Controls<\/h2>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-995f960e wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:33.33%\">\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6ad3829164d17&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6ad3829164d17\" class=\"wp-block-image size-full has-lightbox wp-lightbox-container\"><img loading=\"lazy\" decoding=\"async\" width=\"640\" height=\"1140\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/creativethemes.com\/blocksy\/wp-content\/uploads\/2024\/02\/Screenshot-2024-02-27-at-12.59.47.png\" alt=\"Newsletter block settings in the WordPress editor\" class=\"wp-image-9806\"\/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\tdata-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.thisImage.buttonRight\"\n\t\t\tdata-wp-style--top=\"state.thisImage.buttonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><figcaption class=\"wp-element-caption\">Configuring the Newsletter block.<\/figcaption><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:66.66%\">\n<h3 class=\"wp-block-heading\">List Source<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Choose the provider list or audience that should receive subscriptions submitted through this particular form.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This is especially useful when your provider contains multiple lists, since different Newsletter blocks can send subscribers to different destinations without changing the extension&#8217;s global provider configuration.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Form Style<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Choose how the form fields and subscription button are arranged:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Inline<\/strong> \u2013 places the form elements alongside one another when sufficient horizontal space is available.<\/li>\n\n\n\n<li><strong>Stacked<\/strong> \u2013 places the form elements one underneath another.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Field Height &amp; Spacing<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Adjust the height of the form fields and the spacing between individual elements to better match the surrounding layout.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Name Field<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Enable the <strong>Name<\/strong> field when you want to collect a subscriber&#8217;s name in addition to their email address and the selected newsletter provider supports that information.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The field&#8217;s placeholder can be customised independently to match the wording used by the rest of the form.<\/p>\n<\/div>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>The Newsletter block lets you place a subscription form directly inside layouts created with the WordPress block editor. It connects to Blocksy&#8217;s Newsletter Subscribe extension and sends new subscriptions to the configured email marketing provider. The block can be inserted into posts, pages, Custom Post Types, Content Blocks and other areas where the WordPress block [&hellip;]<\/p>\n","protected":false},"author":6,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"doc_categories":[133],"class_list":["post-9449","documentation","type-documentation","status-publish","hentry","doc_categories-theme-blocks"],"blocksy_meta":{"styles_descriptor":{"styles":{"desktop":"","tablet":"","mobile":""},"google_fonts":[],"version":8}},"acf":[],"_links":{"self":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/9449","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation"}],"about":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/types\/documentation"}],"author":[{"embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/comments?post=9449"}],"version-history":[{"count":9,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/9449\/revisions"}],"predecessor-version":[{"id":15336,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/documentation\/9449\/revisions\/15336"}],"wp:attachment":[{"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/media?parent=9449"}],"wp:term":[{"taxonomy":"doc_categories","embeddable":true,"href":"https:\/\/creativethemes.com\/blocksy\/wp-json\/wp\/v2\/doc_categories?post=9449"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}