WooCommerce Documentation

Everything WooCommerce-specific. For shared topics like suppliers, pricing, and logo handling see the core concept guides below.

Core concepts

Same model across every LogoMagic product — read these once.

Download the logomagic-plugin.zip file from your purchase email.
In WP admin: Plugins → Add New → Upload Plugin. Select the zip, install, then Activate.
Requires WordPress 6.2+, PHP 7.4+, and WooCommerce active. The plugin will show a notice if WC is not active.
After activation, a 'LogoMagic' menu item appears in your WP admin sidebar (position 56).

Open LogoMagic → Settings. The License panel is at the top.
Paste your LM-XXXX-XXXX-XXXX license key and click Activate.
The plugin validates with LogoMagic servers. Valid keys show 'Activated' + the licensed email address.
One license per WooCommerce site. To move a license to a different site, click Deactivate here first, then activate on the new site.
Revalidation runs automatically once per day via WP-Cron to catch revocations.

Set a global markup multiplier + flat fee. Example: 2.5x + $2 = a $10 supplier cost becomes $27.
Price ending rule: round every final price to .99, .95, or whole dollar.
Per-supplier overrides: set different rules for SanMar vs PCNA vs Gemline vs others.
Pricing is applied at publish time. Existing WC products aren't re-priced when you change the rules.

Upload logos you reuse frequently. Up to 50 logos, 200 KB each (PNG or SVG recommended).
Stored as base64 inside wp_options (single row). Backed up with every site backup.
In the workspace, click the 'Library (N)' button on any Logo Choice slot to reuse a saved logo.
Effect defaults (white / black / custom color / embroidery) are saved per-logo.

Publishing creates a variable WC product with local (non-taxonomy) attributes: Color, Size, Logo Choice (if >1 logo).
One variation per combination. Per-variation image (sideloaded into the WP Media Library).
Supplier cost written to variation meta (_cogs + _cogs_value). Compatible with WC 9.6+ first-class Cost of Goods and older conventions.
Products publish as Draft by default. Change the default in Settings → Publish Defaults, or override per-product in the Batch Queue.

The 'Edit Existing' tab searches your WC catalog for products LogoMagic created (identified by the _logomagic_style meta marker).
Click a product to open it in the workspace. Saved settings rehydrate automatically.
Useful for: swapping a logo on 50 products, adjusting pricing, re-publishing after a seasonal catalog refresh.

The Desktop app can publish to this WC site by connecting via WordPress Application Password.
The plugin's REST endpoint (/wp-json/logomagic/v1/publish-product) is license-gated Desktop publishes check the license + return a clear 'buy a license' message if invalid.
Using the Desktop with multiple WooCommerce sites? Each site needs its own $49/year license.

Publish returns 402 Payment Required: your license is missing, invalid, expired, or for a different product. Check LogoMagic → Settings → License.
Publish returns 404 on /publish-product: the plugin isn't active, or your user doesn't have manage_woocommerce capability.
Stuck admin page: add ?_lm=debug to the URL to force-reload the JS bundle past any caches.