General Settings

The General settings tab is the top-level configuration page for TrustLens. It controls the scoring threshold for new customers, checkout blocking, and two display options that affect the rest of the plugin. This page walks through every setting on the tab, explains the effect of each, and points to where related settings live.

Location: TrustLens → Settings → General.

---

Scoring Settings #

Full-confidence Order Threshold #

Default: 3 (range 1–20)

How many completed orders a customer needs before every detection module scores them. Below the threshold, return risk is still evaluated with a reduced, confidence-weighted penalty, and linked-account matches and the account-age bonus apply, but the other local-history modules (orders, coupons, chargebacks, shipping anomalies, and so on) wait. This prevents false positives on new customers with limited history. The same number decides who qualifies for the Card-Testing VIP bypass.

Lower (2) if: Strong signal quality, want faster classification.

Raise (5+) if: Very generous return policy, want extra patience.

Segment Thresholds #

Defaults: VIP 90, Trusted 70, Normal 50, Caution 30, Risk 10, Critical 0

Score boundaries between segments. They have no settings field — developers can change them with the trustlens/segment_thresholds filter. Rarely needs tuning: the defaults match how the rest of the plugin is documented.

Return-Risk Thresholds #

Defaults: 40% high, 60% critical

Trigger points for Returns module signals, set on the Settings → Refunds tab (High risk 10–90%, Critical risk 20–100%). A lower elevated tier at 25% is built in. See Return Abuse Detection for the per-industry tuning recommendations.

---

Checkout Enforcement #

Enable Blocking #

Default: Off

Master toggle for whether blocked-customer status is enforced at checkout. When off, you can still mark customers as blocked — manually, with the Customers bulk action, through a Pro automation rule, or with Pro’s auto-block after lost disputes — but they can still check out. Turn on once you trust the scoring. Allowlisted customers are never stopped by this check.

Block Message #

Default: “We are unable to process your order at this time. Please contact support for assistance.”

The error shown to blocked customers at checkout. Keep neutral — don’t include words like “blocked,” “fraud,” or “risk.” It isn’t used for Card-Testing Defense messages, which have their own fixed wording.

---

Display Settings #

Dashboard Integration #

Default: On

Shows the “TrustLens – Customer Trust” widget on the WordPress Dashboard for users who can manage WooCommerce.

Order Warnings #

Default: On

Shows the Customer Trust box with the customer’s trust information on the WooCommerce order edit screen. On Pro, this box also carries the Dispute Report link.

---

Settings That Live Elsewhere #

Setting	Where
Card-Testing Defense on/off, thresholds, VIP customer bypass, event retention, Browser Challenge	TrustLens → Card-Testing Defense
Detection modules on/off and module options	Settings → Detection
Return-risk thresholds, Refund Defense, product risk by category	Settings → Refunds
Email notifications	Settings → Alerts & Reports
Historical Sync, uninstall behavior	Settings → Data

There are no privacy display options (customer emails always show to users who can manage WooCommerce), no automatic erasure of inactive customers, and no performance settings.

---

Saving and Validation #

Settings save with WordPress’s standard form submission. Most settings take effect immediately on save; some (like the order threshold) only show in a customer’s score after it is recalculated — use the Recalculate Score bulk action on the Customers list to force it.

Values are sanitized on save: numbers outside their allowed range are clamped to it.

---

Restoring Defaults #

There is no Restore Defaults button. To return a setting to its default, enter the default value shown on this page and save.

Changing settings doesn’t delete customer data or scoring history — only the settings.