Behavior and display
The Behavior tab controls how users interact with your storefront: portal access, checkout options, catalog display, pricing, user accounts, analytics tracking and performance settings.
Go to Propeller > Behavior in your WordPress admin to access these settings.
Basic configuration
| Setting | Description |
|---|---|
| Shop home country | The home country of the webshop. Drives ICP settings, default tax zones and regional configurations. |
Access and security
These settings control who can access the storefront and which security features are enabled.
| Setting | Description |
|---|---|
| Closed portal mode | When enabled, anonymous users land on the login page. They cannot browse the catalog, see prices or access any storefront content until they log in. |
| Semi-closed portal mode | When enabled, anonymous users can browse the catalog but cannot see prices, stock levels or add products to the cart. They must log in to access pricing and ordering. |
| Allow guest checkout | When enabled, visitors can place orders without creating an account. |
| Enable SSO | Enables Single Sign-On authentication. Allows users to log in through an external identity provider instead of the plugin's built-in login. |
| Enable reCAPTCHA | Adds Google reCAPTCHA to forms (login, registration, contact) to prevent automated submissions. |
| Enable Google Analytics 4 & Tag Manager | Enables integration with Google Analytics 4 and Google Tag Manager for tracking storefront events (page views, add to cart, purchases). |
| Enable cXML Punchout | Enables cXML Punchout support for B2B procurement. Allows buyers to access the catalog from their procurement system, select products and send the cart back as a purchase order. |
note
Closed portal mode and semi-closed portal mode are mutually exclusive. Closed portal mode redirects anonymous users to the login page. Semi-closed portal mode lets anonymous users browse products but hides prices, stock levels and add-to-cart functionality until they log in.
If neither is enabled, the storefront operates as an open portal where anonymous visitors can browse, see prices and place orders.
Checkout and cart
These settings control checkout behavior and which options are available during the order process.
| Setting | Description |
|---|---|
| On account payment types | Comma-separated list of payment type identifiers for which third-party payment providers are skipped (for example REKENING). Orders placed with these payment types are invoiced to the customer's account rather than routed through a payment provider. |
| Enable partial delivery | Allows orders to be split into multiple shipments. When enabled, customers can choose to receive available items first and have the rest shipped later. |
| Enable carrier selection | Shows a carrier selection step during checkout. Customers can choose their preferred shipping carrier. |
| Enable delivery date picker | Shows a date picker during checkout so customers can select a preferred delivery date. |
| Show action code field | Displays a field during checkout where customers can enter an action code (discount code or promotion code). |
| Show order type field | Displays a field during checkout where customers can specify the order type. |
Product catalog and display
Configure default sorting behavior and pagination for category, search and brand listing pages.
| Setting | Description |
|---|---|
| Default sort field | The field used to sort product listings by default. Options include Modified, Name, Price and other product fields. |
| Secondary sort field | Tie-breaker sort applied to product listings, when multiple products have the same value for the default sort. For example, if the Default sort field is set to price, products with identical prices would appear in an unpredictable order. The Secondary sort field (e.g., name) ensures those tied products are then sorted alphabetically. |
| Direction | The default sort direction: ascending (Asc) or descending (Desc). |
| Per page | Number of products shown per page in the catalog listing. |
| Auto-load product specifications | When enabled, product specifications (attributes) are automatically loaded in the background on product detail pages. |
| Enable stock validation | When enabled, displays a warning popup when the ordered quantity exceeds available stock. |
| Product page tab behavior | Controls whether customers can toggle product detail pages to open in new tabs while browsing catalog pages. Options: On (PDP pages open in a new browser tab), Off (PDP pages open in the same tab) or Hidden (the toggle option is not shown to customers and remains off). |
Pricing and tax
| Setting | Description |
|---|---|
| Include VAT by default | When enabled, prices are displayed including VAT throughout the storefront and the VAT switcher defaults to VAT-inclusive. |
User accounts
These settings control account registration and management features.
| Setting | Description |
|---|---|
| Automatic login after registration | When enabled, new users are automatically logged in after completing registration instead of being redirected to the login page. |
| Allow address management | When enabled, users can add new addresses and edit existing ones in their account. |
| Allow account management | Enables customers with the authorization manager role to create and delete accounts for their company. |
Display options
These settings define which attributes are used to personalize content and enhance tracking. Each field accepts a comma-separated list of Propeller attribute names.
| Setting | Description |
|---|---|
| User tracking attributes | The attribute used to personalize content and track behavior for individual users. |
| Company tracking attributes | Attributes used to personalize content for company accounts (comma-separated). |
| Product tracking attributes | Attributes used to display additional product information and enhance tracking (for example PROPELLER_CATEGORIE,PROPELLER_TYPE). |
| Category tracking attributes | Attributes used to display additional category information and enhance tracking. |
Performance and technical
These settings affect how the plugin handles sessions, assets and URLs.
| Setting | Description |
|---|---|
| Enable WordPress sessions | Integrates and synchronizes Propeller sessions with WordPress sessions. |
| Assets enqueuing type | Controls how the plugin loads its CSS and JavaScript files. Standard loads assets only where needed (use plugins like Autoptimize for optimization). Global/Minified combines and minifies all assets but loads them globally, which may impact performance. |
| Enable lazy loading for images | Lazy loads images from the API on category, brand, search and product detail pages to improve performance. |
| Use session language for attributes | When enabled, attributes are fetched only in the currently selected language instead of retrieving all available language versions. |
| Include ID in product/category URLs | Appends the object ID to product and category URLs for improved tracking and consistency. |
Next steps
- Translations and valuesets — manage UI labels and value lists