Hide/Rename/Move Payment Method Action

Hide, rename, or reorder payment methods at checkout, with flexible name matching.

Overview

The Hide/Move/Rename payment methods block lets you customize how payment methods appear during checkout. A single block can hide, rename, and reorder multiple methods at once — you build a list of payment method names and choose what to do with each one.

• Hide payment methods — remove options based on customer tags, cart value, products, or destination
• Rename payment methods — clarify names, localize them, or add promotional context
• Reorder payment methods — prioritize preferred options at the top of the list
• Match flexibly — match payment method names exactly, by substring, or with a regular expression

Setup

Settings

Name matching

Required

Controls how the names you enter in the list are matched against the payment methods available at checkout. The selected mode applies to every entry in the list.

Exact match

Names are compared against the full payment method name, case-sensitive. Use this when you know the exact label Shopify shows at checkout (for example, PayPal Express Checkout).

Partial match (contains)

Each entry matches any payment method whose name contains it (case-insensitive). Useful when a provider’s checkout label varies — for example, entering paypal matches PayPal, PayPal Express Checkout, and Pay with PayPal.

Regular expression

Each entry is treated as a regular expression pattern (case-insensitive). Supports ., *, +, |, (), and \. Useful when you need to match several variants in a single rule — for example, paypal|stripe matches either provider, and (Cash|Bank).* matches any method whose name starts with “Cash” or “Bank”.

Add payment method

Type a payment method name (or a substring/pattern, depending on the matching mode) and click Add payment method to add it to the list. Each entry in the list can then be renamed, hidden, or reordered independently.

The placeholder and example shown depend on the selected matching mode:

• Exact — enter the full payment method name as it appears at checkout
• Partial — enter a substring; e.g. paypal matches PayPal Express Checkout
• Regexp — enter a pattern; e.g. paypal|stripe matches either provider

Payment method list

Each entry in the list has three controls:

Rename

Click Rename to set a new display name for the matching payment method(s). When set, the new name replaces the original at checkout. Leave the rename empty to keep the original name.

Visibility

Click the visibility icon to toggle whether matching payment methods are shown or hidden at checkout. The icon reflects the current state — an eye icon means the method is visible, a crossed-out eye means it is hidden.

Remove

Click the trash icon to remove the entry from the list.

Drag handle

Use the drag handle on the left of each row to reorder entries. The list order determines the on-checkout order when Apply list order to payment methods is on.

Apply list order to payment methods

When on (default), the order of entries in the list is applied as the on-checkout order — the topmost entry appears first at checkout.

When off, payment methods keep their original position. Use this when you only want to rename or hide methods without moving them.

How It Works

When the function runs, it walks every payment method offered at checkout and matches it against each entry in your list using the selected Name matching mode:

1. Match — for each available payment method, the first list entry that matches it (according to the matching mode) determines what happens to it
2. Hide — if the matched entry has visibility off, the payment method is hidden from checkout
3. Rename — if the matched entry has a rename set, the payment method is displayed with the new name
4. Reorder — if Apply list order is on, payment methods are sorted to follow the list order; methods that did not match any entry keep their original relative order at the end

Examples

Hide PayPal for Wholesale Customers (Exact)

Hide PayPal at checkout for customers tagged wholesale.

Hide All PayPal Variants (Partial)

A merchant has both PayPal and PayPal Express Checkout enabled and wants to hide them in one rule.

Hide Cash and Bank Methods (Regular Expression)

Hide both Cash on Delivery and Bank Transfer with a single regex rule, and rename them in case the rule changes later.

Rename Without Reordering (Exact)

Add an estimated delivery hint to a payment method’s label without changing its checkout position.

Prioritize Shop Pay (Exact)

Move Shop Pay to the top of the payment methods list.

Best Practices

Choosing a Matching Mode

• Exact is the safest default — it never matches more than the method you intend
• Partial is convenient when a provider’s label has variants (e.g. multiple PayPal-branded methods)
• Regexp is best when several distinct providers should share one rule, or when you need anchoring/alternation

List Ordering

• Put more specific entries above more general ones — only the first matching entry applies to a given payment method
• Turn Apply list order off if you are only renaming or hiding, so you do not unintentionally reorder methods

Customer Experience

• Always leave at least one payment method visible at checkout — hiding every option breaks the checkout flow
• When renaming, keep the new label short and recognizable
• Test customizations with several customer scenarios before publishing

Important Considerations

Troubleshooting

Entry Does Not Match Any Payment Method

• Check the matching mode — PayPal will not match PayPal Express Checkout in Exact mode; switch to Partial or use the full name
• Check casing in Exact mode — exact matching is case-sensitive
• Check your regex — test patterns against the full payment method name; remember the match is case-insensitive but otherwise standard regex syntax

Method Is Hidden Unexpectedly

• Check for an over-broad partial entry — a short substring like pay will match many methods
• Check the order of entries — only the first matching entry applies; an earlier hide entry will pre-empt a later rename entry

Reordering Has No Effect

• Confirm Apply list order is on — when off, the list order is ignored
• Confirm the entry actually matches a method — methods that do not match any entry keep their original order at the end of the list

Regex Not Matching as Expected

• Escape special characters — to match a literal . write \.
• Anchors are not implicit — use ^ and $ if you need to anchor a pattern to the start or end of the name
• See the reference — Regular Expressions lists the supported syntax

Related Actions

• Hide/Rename/Move Delivery Option
• Hide Shipping Methods