dzinedStart a project

All documentationSimple Product Personalisation

Simple Product Personalisation

Complete setup and configuration guide

Simple Product Personalisation v2.1.0

Requirements

Requirements

This plugin requires WooCommerce 5.0+ and is compatible with WooCommerce High-Performance Order Storage (HPOS).

Works with both simple and variable products. No additional plugins or page builders required.

Installation

  1. Upload the plugin

    Download the plugin ZIP file from your purchase confirmation email. In your WordPress admin, go to Plugins → Add New → Upload Plugin and select the ZIP. Alternatively, upload the woo-personalisation folder to /wp-content/plugins/ via FTP.

  2. Activate the plugin

    Go to Plugins and click Activate on “Simple Product Personalisation”.

  3. Enter your licence key

    A licence prompt will appear in admin. Enter the key from your purchase email to activate updates and support.

Enabling Personalisation on a Product

Personalisation is configured on a per-product basis. You choose which products allow personalised text.

  1. Edit a product

    Open any product (simple or variable) in the WordPress admin editor.

  2. Go to the Personalisation tab

    In the Product Data panel, click the “Personalisation” tab.

  3. Enable personalisation

    Tick the “Enable personalisation” checkbox. This will activate the personalisation text field on the product page.

  4. Configure the field settings

    Set the following options:

    • Field Label: the label shown to customers, e.g. “Enter your personalisation text” or “Engraving text”.
    • Required: whether the field must be filled in before adding to cart.
    • Minimum Characters: the minimum number of characters the customer must enter (0 for no minimum).
    • Maximum Characters: the maximum number of characters allowed (0 for no maximum).
  5. Save the product

    Click Update or Publish to save. The personalisation field will now appear on the product page.

Frontend Experience

When a customer visits a product with personalisation enabled, they’ll see:

  1. A labelled text input field above the Add to Cart button.
  2. A helper text showing min/max character limits (if configured).
  3. A live character counter that updates as they type (when a max limit is set).
  4. Validation that prevents adding to cart if the field is required but empty, or if character limits are not met.

The entered text is validated on submission. If validation fails, a clear WooCommerce notice is shown explaining what needs to be corrected.

Cart, Checkout & Orders

Once personalised text is entered and the product is added to cart, the text flows through the entire order process:

Where personalisation text appears
WhereWhat customers and staff see
CartPersonalisation text is displayed below the product name in the cart table. Each line item shows its unique personalisation.
CheckoutText is visible in the order review section so customers can verify before payment.
Order ConfirmationDisplayed on the order received (thank-you) page and in the customer's order history.
Admin OrdersPersonalisation text is shown in the order line items in WooCommerce → Orders, making it easy to fulfil.
EmailsIncluded in both admin notification and customer order confirmation emails.

Tips & Best Practices

  • Use a clear, descriptive field label so customers know exactly what to enter (e.g. “Name for engraving” rather than just “Text”).
  • Set a maximum character limit appropriate to your product, for example, 20 characters for a bracelet engraving or 100 for a gift message.
  • If personalisation is essential to the product (e.g. a name necklace), mark the field as required.
  • Test the experience by adding a personalised product to your own cart to ensure the text appears everywhere as expected.
  • The personalisation text is sanitised to prevent any security issues: HTML tags are stripped automatically.

Frequently Asked Questions

Does it work with variable products?
Yes. The personalisation field appears for both simple and variable products. The text is associated with the cart line item, not the variation.
Can I add multiple personalisation fields?
The current version supports a single text field per product. If you need multiple fields, contact support to discuss customisation options.
Does personalisation add an extra cost?
Not automatically. The plugin focuses on capturing text input. If you need to charge an additional fee for personalisation, this can be achieved with a complementary pricing plugin.
Is it compatible with HPOS?
Yes. The plugin declares full compatibility with WooCommerce High-Performance Order Storage.