Skip to content
WPPoland Documentation

Configuration

Registry has a small store-side settings screen at WooCommerce → Gift Registries; most of the experience happens for customers under My Account and on the public registry pages. This page explains the settings and the moving parts.

Allow direct purchase

Section titled “Allow direct purchase”

The main store setting. It controls what the buy button on a shared registry page does:

  • On — guests can buy a registry item straight from the public registry page, adding it to the cart in one step.
  • Off — the buy button sends guests to the product page, where they purchase normally.

Turn it off if your products need options chosen on the product page (variations, add-ons) before buying; turn it on for the smoothest gifting flow.

What a customer controls

Section titled “What a customer controls”

Each registry is created and managed by the customer under My Account → Gift Registries:

  • Name — a title for the registry.
  • Event type — wedding, baby shower, birthday, housewarming, and similar.
  • Event date — the date of the occasion.
  • Items — products added from any product page with a desired quantity.

Ownership is enforced on every action, so one customer can never see or change another’s registry.

The public registry page

Section titled “The public registry page”

Every registry has a clean, read-only public permalink to share with friends and family. It shows the registry name, event details, the items with desired quantities, how many have been purchased, and how many remain. Guests use it to buy gifts without needing an account.

Purchase tracking

Section titled “Purchase tracking”

This is the core of Registry and needs no configuration. When a gift is bought through a registry, the order line item records which registry it belongs to. Once the order is paid, the purchased quantity is added to the registry. The public page then marks fulfilled items and lowers the remaining count automatically — so two guests do not unknowingly buy the same gift.

The shortcode

Section titled “The shortcode”

Embed a specific registry on any page with:

[gift_registry id="123"]

Replace 123 with the registry’s ID. Useful for an event landing page or a featured registry. See Using registries for details.

Section titled “Related”