WordPress Plugin - Marzipan Docs

The Marzipan for WordPress plugin integrates Marzipan’s web components directly into your WordPress site, providing Gutenberg blocks, Elementor widgets, and shortcodes for displaying products, carts, and subscription management.

Requirements

WordPress 6.0 or higher
PHP 7.4 or higher
A Marzipan account with API access

Installation

Download the plugin from your Marzipan dashboard
Upload the marzipan-for-wordpress folder to /wp-content/plugins/
Activate the plugin through the Plugins menu in WordPress
Navigate to Settings > Marzipan to configure

Activating the Marzipan plugin in WordPress

Configuration

After activation, go to Settings > Marzipan to enter your API token.

Getting Your API Token

Log into your Marzipan dashboard
Navigate to Settings > API
Create an API token

Settings Page

The settings page displays:

API Token - Your Marzipan API token (required)
Pages - Links to view and edit the auto-generated pages

Auto-Generated Pages

On activation, the plugin automatically creates six pages with locked Gutenberg blocks:

Page	URL	Purpose
Store	`/store`	Product collection display
Product	`/product`	Individual product detail template
Cart	`/cart`	Shopping cart
Checkout	`/checkout`	Checkout form
Account	`/account`	Customer account management
Contact	`/contact`	Contact form

These pages contain locked blocks that cannot be accidentally deleted, ensuring your store functions correctly.

Gutenberg Blocks

The plugin provides 9 Gutenberg blocks in the Marzipan category:

Collection Block

Display products from a specific collection with filtering options.

Product Block

Display a single product with configurable view modes (mini or full).

Product Page Block

Full product detail page template with all product information.

Add to Cart Block

A dedicated add-to-cart button with quantity options.

Cart Block

Shopping cart displaying line items and totals.

Checkout Block

Complete checkout form for processing orders.

Account Block

Customer account portal for managing subscriptions and orders.

Form Block

Dynamic form that renders a form created in your Marzipan dashboard. Select the form by slug in the block settings.

Cart Icon Block

Cart icon with item count badge, perfect for navigation menus.

All Marzipan blocks in the block inserter

Elementor Widgets

If you use Elementor, the plugin provides 7 widgets:

Product
Collection
Add to Cart
Cart
Account
Form
Cart Icon

Find them in the Elementor widget panel under the Marzipan category.

They can be easily dragged and dropped into any Elementor layout and then configured via the widget settings.

Shortcodes

For use in the classic editor, template files, or anywhere WordPress shortcodes are supported. Shortcodes accept the same settings as the web component props, using underscores instead of hyphens.

Shortcode	Description
`[marzipan_collection]`	Display a product collection
`[marzipan_product]`	Display a single product
`[marzipan_addtocart]`	Add to cart button
`[marzipan_cart]`	Shopping cart
`[marzipan_checkout]`	Checkout form
`[marzipan_product_page]`	Full product page
`[marzipan_account]`	Customer account portal
`[marzipan_form]`	Dynamic form
`[marzipan_carticon]`	Cart icon with count

Collection Shortcode

Display products from a specific collection with full control over display options.

[marzipan_collection
  collection="red-wines"
  show_description="true"
  show_subscriber_pricing="true"
  placeholder_items="12"
  add_to_cart_text="Buy Now"
  redirect_to_cart="false"
]

Attribute	Description	Default
`collection`	Collection slug (required)	—
`show_collection_name`	Show the collection title	`true`
`show_description`	Show product descriptions	`default`
`show_more_link`	Show “view more” link on products	`false`
`show_more_text`	Text for the “view more” link	`More`
`placeholder_items`	Number of loading placeholders	`8`
`hide_add_to_cart_button`	Hide the add to cart button	`false`
`show_cart_quantity`	Show quantity selector	`default`
`redirect_to_cart`	Redirect to cart after adding	`default`
`add_to_cart_text`	Custom button text	`Add to Cart`
`show_subscriber_pricing`	Show member pricing	`default`
`sale_badge_text`	Text for sale badges	`Sale`
`subscriber_badge_text`	Text for subscriber badges	`Subscribers`
`subscriber_price_label`	Label for subscriber pricing	`for subscribers`
`bundle_text`	Unit text for bundles	`bundle`

Attributes set to default will use the value configured in your web component settings.

Product Shortcode

Display a single product in either mini (card) or full (page) view.

[marzipan_product product="reserve-cabernet" view="full"]

Attribute	Description	Default
`product`	Product slug or ID (required)	—
`view`	Display mode: `mini` or `full`	`mini`
`show_collection_name`	Show the collection name	`true`
`show_subscriber_pricing`	Show member pricing	`default`
`hide_add_to_cart_button`	Hide the add to cart button	`false`
`redirect_to_cart`	Redirect to cart after adding	`false`
`add_to_cart_text`	Custom button text	`Add to Cart`
`sale_badge_text`	Text for sale badges	`Sale`
`subscriber_badge_text`	Text for subscriber badges	`Subscribers`

Add to Cart Shortcode

A standalone add-to-cart button for embedding anywhere on your site.

[marzipan_addtocart
  product_id="550e8400-e29b-41d4-a716-446655440000"
  product_type="physical"
  button_text="Add to Cart"
  show_quantity="true"
]

Attribute	Description	Default
`product_id`	Product UUID (required)	—
`product_type`	`physical`, `bundle`, `event`, or `subscription`	`physical`
`button_text`	Custom button text	`Add to Cart`
`show_quantity`	Show quantity selector	`false`
`quantity`	Default quantity	`1`
`redirect`	Redirect to cart after adding	`false`
`availability`	`all` or `subscribers`	`all`
`out_of_stock`	Show as out of stock	`false`
`disabled`	Disable the button	`false`

Cart Shortcode

[marzipan_cart empty_cart_message="Your cart is empty — browse our wines!"]

Attribute	Description	Default
`empty_cart_message`	Custom empty cart message	`You have nothing in your cart.`

Cart Icon Shortcode

A small cart icon with item count badge, ideal for navigation menus or headers.

[marzipan_carticon icon_style="bag-outline" cart_path="/cart"]

Attribute	Description	Default
`cart_path`	Path to the cart page	`/cart`
`icon_style`	`cart-outline`, `cart-solid`, `bag-outline`, or `bag-solid`	`bag-outline`

Account Shortcode

[marzipan_account disable_pick_mix_subscription_edit="false"]

Attribute	Description	Default
`disable_pick_mix_subscription_edit`	Prevent customers from editing pick & mix selections	`false`

Form Shortcode

Display a form created in your Marzipan dashboard.

[marzipan_form slug="contact-us"]

Attribute	Description	Default
`slug`	Form slug as defined in your dashboard (required)	—
`button_text`	Custom submit button text	`Submit`
`success_message`	Custom success message	Form setting

Checkout Shortcode

[marzipan_checkout]

No attributes are required for the checkout shortcode.

Product URLs

Product detail pages are automatically accessible at /store/{product-slug}. The plugin handles URL rewriting so visitors see the full product page when navigating to a product. For example, if you have a product with the slug reserve-cabernet, it will be accessible at:

https://yoursite.com/store/reserve-cabernet

SEO Integration

The plugin integrates with popular SEO plugins to ensure proper canonical URL handling on product pages:

Yoast SEO
RankMath
SEOPress
All in One SEO

Theme Compatibility

The plugin works with any WordPress theme. All auto-generated pages use your active theme’s templates, headers, and footers.

If you use a caching plugin, you may need to exclude the cart and checkout pages from caching to ensure real-time cart updates.

Troubleshooting

Pages Not Displaying Correctly

If a page was accidentally deleted, you can recreate it from the Settings > Marzipan page. Click the Create button next to the missing page.

Products Not Loading

Verify that:

Your API token is entered correctly
Your Marzipan account is active
You have products configured in your Marzipan dashboard

Styling the Components

See the Styling guide for customizing the appearance of components to match your branding.

Uninstalling

When the plugin is uninstalled:

The API token setting is removed
Rewrite rules are flushed
Created pages are not automatically deleted (you can remove them manually if desired)

​Requirements

​Installation

​Configuration

​Getting Your API Token

​Settings Page

​Auto-Generated Pages

​Gutenberg Blocks

​Collection Block

​Product Block

​Product Page Block

​Add to Cart Block

​Cart Block

​Checkout Block

​Account Block

​Form Block

​Cart Icon Block

​Elementor Widgets

​Shortcodes

​Collection Shortcode

​Product Shortcode

​Add to Cart Shortcode

​Cart Shortcode

​Cart Icon Shortcode

​Account Shortcode

​Form Shortcode

​Checkout Shortcode

​Product URLs

​SEO Integration

​Theme Compatibility

​Troubleshooting

​Pages Not Displaying Correctly

​Products Not Loading

​Styling the Components

​Uninstalling

Requirements

Installation

Configuration

Getting Your API Token

Settings Page

Auto-Generated Pages

Gutenberg Blocks

Collection Block

Product Block

Product Page Block

Add to Cart Block

Cart Block

Checkout Block

Account Block

Form Block

Cart Icon Block

Elementor Widgets

Shortcodes

Collection Shortcode

Product Shortcode

Add to Cart Shortcode

Cart Shortcode

Cart Icon Shortcode

Account Shortcode

Form Shortcode

Checkout Shortcode

Product URLs

SEO Integration

Theme Compatibility

Troubleshooting

Pages Not Displaying Correctly

Products Not Loading

Styling the Components

Uninstalling