Installing the Alter Product plugin for WordPress

Before you start

Install Alter Product as a plugin for WordPress. It requires WooCommerce to be installed and active to manage your store’s products, variants, cart and orders.

Before installing the plugin, make sure your site meets the minimum requirements:

  • WordPress: 6.4+
  • WooCommerce: 6.0+ (installed and activated)
  • PHP: 8.0+
  • A server with HTTPS / SSL enabled is required for security reasons
  • An Alter Product account is required (you will use Access Key + Access Token)

Important: the plugin runs the customizer, configurator or viewer in an isolated iframe, so it does not modify WooCommerce core checkout behavior.

Plugin installation and account connection

  1. Log in to your WordPress admin panel and make sure WooCommerce is installed and active.
  2. In WordPress Admin, go to Plugins → Add New and search for Alter Product - 3D Configurator for WooCommerce. Install and activate the plugin.* Optional: upload the ZIP manually and activate it.
  3. In WordPress Admin, open Alter Product and click Connect in Auto Connect.* Optional manual setup: create API keys on the Alter Product API Settings page, copy the Access Key and Access Token, then add your store domain in Embedding Settings.
  4. Follow the setup steps shown in the Alter Product plugin in WordPress Admin.
  5. Prepare your first design — open the WooCommerce product editor in WordPress Admin. In the Alter Product tab, create a new design or select an existing one and map it to the product. Define variants that match the WooCommerce product, optionally activate the Customizer, and save the project.

After plugin setup

Once the plugin is configured in WordPress, you can:

  • Manage assets, including Products, Variants, Mockups, Graphic Library, Logos, Design Templates, Backgrounds, Environments, and Fonts
  • Import projects from Alter Product storage
  • Create and manage product designs
  • Show a button for the selected e-commerce tool on public WooCommerce shop pages or product pages
  • Embed Viewer / Configurator / Customizer on WooCommerce product pages or WordPress pages
  • Map WooCommerce products to Alter Product designs
  • Let customers personalize products (text, images, layouts, QR codes, etc.)
  • Synchronize selected configuration to the WooCommerce cart

Troubleshooting

  • API test fails: verify Access Key / Access Token and your server connectivity to https://alterproduct.com/public-api Alter Product → Status.
  • Problems downloading assets: go to Alter Product → Status and make sure your server meets the requirements in the Server resources table.
  • Iframe is blank / no communication: make sure your store domain is added in Alter Product E-commerce Settings → Integration, or verify that your server uses HTTPS with a valid SSL certificate.
  • Permalinks issue: if Customizer, Configurator, or Viewer pages show Not found, go to Settings → Permalinks and click Save Changes to refresh rewrite rules.
  • Add to cart not working: confirm product mapping is complete and the embedded tool has e-commerce actions enabled.