1 Overview
2 Installation
- 2.1 Installing the plugin
  - 2.1.1 Click Download to begin the installation
  - 2.1.2 UltraCart Wordpress Plugin Settings
  - 2.1.3 Shortcodes and Blocks
  - 2.1.4 [uc_buy_button] shortcode and Buy Button block
  - 2.1.5 [ucitem] shortcode and Item block
  - 2.1.6 [uc_price] shortcode and Price block
  - 2.1.7 [ucitem_list] shortcode and Item List block
  - 2.1.8 [uc_if] shortcode (conditional content)
- 2.2 Configuring items to display in the Wordpress site.
3 Inspecting and the Log
- 3.1 Authorized Applications
- 3.2 Webhook Log
4 Disconnecting and Reconnecting the Wordpress Plugin to Resolve Credentials Errors Issues
- 4.1 Inside of Wordpress Administration
5 Troubleshooting FAQ

Overview

The Ultracart WordPress plugin provides a quick and easy integration of your UltraCart account with your WordPress hosted website.

This document will detail the steps to installing the UltraCart WordPress Plugin.

Installation

Getting Started

Install The plugin and Activate the plugin
Connect your site to UltraCart via Settings → UltraCart
Add eCommerce components to your site

NOTE: You can Install UltraCart eCommerce - Shopping Cart via the WordPress plugin directory, or by uploading the files manually to your server.

After becoming an UltraCart merchant, use the plugin to connect your accounts and authorize your site to use UltraCart via Settings → UltraCart in the WordPress admin menu.

Installing the plugin

The UltraCart WordPress plugin is located at the following URL:

https://wordpress.org/plugins/ultracart-ecommerce-shopping-cart/

Click Download to begin the installation

Installing the UltraCart Wordpress Plugin

Log into your Wordpress account, then from the main menu, click Plugins, then click Add New
Search the Plugins for Ultracart
Click Install Now button for the UltraCart Plugin
After the plugin installs, you'll be prompted to 'Activate' the plugin. Click the activate button.
The UltraCart Wordpress plugin is now installed:

UltraCart Wordpress Plugin Settings

After the Plugin has been installed and activated, you can access the plugin settings by
clicking the 'Settings' from the Wordpress main menu, then clicking UltraCart in the submenu that appears:

You'll be presented with the UC Wordpress settings:

Upon installation of the UltraCart Wordpress plugin, item synching will be triggered. This will take a few moments to complete.

There are a few options that can be configured:

Option	Description	Recommended

Option	Description	Recommended
Disable Passive Branding	When enabled, the UltraCart Passive Branding will be disabled.
Enable UltraCart Analytics	When enabled, the UltraCart Analytics script will be inserted into the Wordpress pages.	Yes
Enable UltraCart Analytics Screen Recording	When enabled, the UltraCart Analytics script will load with an optional flag set to instruct it to also capture screen recording data. This can only be enabled if "Enable UltraCart Analytics" is also enabled. To learn more about UltraCart Screen Recordings and Heatmaps, read more about it at StoreFront Recordings
Secure Host Name (Optional)	The wordpress plugin makes the assignment automatically by looking at the host address of the URL when adding an item to the cart. If the domain of the wordpress site matches a domain assigned to one of your storefront hosts, it will will use that one (i.e. - www.yourdomain.com and you have secure.yourdomain.com then it will use that storefront when the customer checks out). Alternatively, if the wordpress website domain matches the subdomain portion of your storefront using the Ultracart built in host addresses, it will use that storefront: www.yourdomain.com, yourdomain.ultracartstore.com or yourdomain.ultracartdev.com if the storefront host does not exist.

The 'Menu Options' section of the UltraCart Wordpress plugin settings allow you to customize the Wordpress menus
with "View cart/Checkout" links.

Shortcodes and Blocks

We recommend using the UltraCart blocks whenever you are working in the WordPress block editor. Blocks let you pick products, set options with toggles, and preview changes without writing code. Shortcodes are still available and work anywhere shortcodes are supported.

[uc_buy_button] shortcode and Buy Button block

What it does: shows an “Add to Cart”/“Buy” button for a single item.
Key arguments:
- itemid (required) – the item’s ID from UltraCart.
- currency_conversion (optional) – show the price in a different currency (e.g., AUD, EUR).
- immediate_checkout (optional) – set to "true" to send shoppers straight to checkout after clicking; defaults to "false".
Example: [uc_buy_button itemid="Hat" currency_conversion="AUD" immediate_checkout="true"]
Block version: use the Buy Button block, select the item, choose currency, and toggle “Immediate checkout” if desired.

[ucitem] shortcode and Item block

What it does: displays a full product block (title, gallery, price, quantity, options, descriptions, etc.).
Key arguments:
- itemid (required) – the item’s ID from UltraCart.
- Section toggles (optional, default to showing): set to "false" to hide title, gallery, extended_description, extended_description_esc, price, quantity, auto_order_schedules, or options.
- immediate_checkout (optional) – "true" to skip the cart and go to checkout on add; defaults to "false".
- currency_conversion (optional) – show pricing in a specific currency code.
Example: [ucitem itemid="Hat" gallery="false" options="false" currency_conversion="EUR"]
Block version: use the Item block to pick the product, toggle which sections to show, choose currency, and optionally enable immediate checkout—no shortcode editing needed.

[uc_price] shortcode and Price block

What it does: shows only the price of a single item.
Key arguments:
- itemid (required) – the item’s ID from UltraCart.
- currency_conversion (optional) – display the price in another currency.
Example: [uc_price itemid="Hat" currency_conversion="GBP"]
Block version: use the Price block to select the item and currency.