Keyword Configuration

Keyword configuration is the most common source of support questions. If the pickup point widget is not appearing for your customers, the keyword setting is almost always the cause. This guide explains exactly how keyword matching works and how to configure it correctly.

How Keyword Matching Works

When a customer reaches checkout and selects a shipping method, the app checks whether the name of that shipping method contains your configured keyword.

The matching logic is:

shippingTitle.toLowerCase().includes(keyword)

In plain English:

• The shipping method name is converted to lowercase.
• The app checks whether your keyword appears anywhere in that name.
• The match is case-insensitive — zasilkovna, Zasilkovna, and ZASILKOVNA all work.

If a match is found, the widget for that carrier is shown. If no keyword matches, the widget defaults to Zásilkovna.

Rules for Keywords

• Substring matching — the keyword must appear somewhere in the shipping method name. Multi-word keywords work as long as the shipping title contains that exact substring (e.g., pickup point will match “Zásilkovna pickup point”).
• Comma-separated for multiple — the app may support comma-separated keywords for matching multiple terms (e.g., zasilkovna,packeta). Check the Interface Settings page for the exact input format supported by your version.
• One keyword field per carrier — each carrier has its own keyword field. On the Premium plan, you can configure a separate keyword for each carrier.
• Keywords must match the shipping method name — the keyword you enter must appear in the exact shipping method name you have configured in Shopify.

Step-by-Step Configuration

1. Find your shipping method name

Go to Shopify Admin → Settings → Shipping and delivery. Look at the names of your shipping rates. Make a note of the exact name of the shipping method you use for Zásilkovna or Packeta pickup points.

For example:

• “Zásilkovna - pickup”
• “Packeta - výdejní místo”
• “Zásilkovna Z-BOX”

2. Choose a keyword

Pick a word that appears in that shipping method name. It should be unique enough that it won’t accidentally match other shipping methods.

Shipping Method Name	Good Keyword	Why
”Zásilkovna pickup”	zasilkovna	Unique to Zásilkovna methods
”Packeta - výdejní místo”	packeta	Unique to Packeta methods
”GLS ParcelShop”	gls	Unique to GLS methods
”DPD Pickup”	dpd	Unique to DPD methods

3. Enter the keyword in the app

1. Open the app in your Shopify admin.
2. Go to Interface Settings.
3. Find the Keyword field for the relevant carrier.
4. Enter your keyword (lowercase recommended, though it doesn’t matter technically).
5. Save the settings.

4. Test the match

Place a test order and select the shipping method. The pickup point widget should appear on the Thank You page.

Multiple Keywords for One Carrier

If you have multiple shipping methods for the same carrier (for example, “Zásilkovna - standard” and “Zásilkovna - Z-BOX”), you can match both with a single keyword by using the common word: zasilkovna.

If the shipping methods use different words, you can enter multiple keywords separated by commas:

zasilkovna,packeta

Tip

The comma-separated list works for a single carrier field. Both keywords will trigger the same carrier’s pickup point widget.

Common Mistakes

Mistake 1: Keyword doesn’t match the shipping method name

The most common error. The keyword you entered does not appear in the exact name of your Shopify shipping method.

Fix: Go to Shopify → Settings → Shipping and delivery, copy the exact name of your shipping method, and make sure your keyword is a substring of that name.

Mistake 2: Extra spaces in the keyword field

Accidentally entering zasilkovna (with a trailing space) instead of zasilkovna will cause the match to fail.

Fix: Remove any leading or trailing spaces from the keyword field.

Mistake 3: Keyword phrase doesn’t match the shipping title

If you enter a keyword phrase (e.g., “Zásilkovna pickup”), it will only match if the shipping method name contains that exact substring in sequence. For example, “Zásilkovna pickup point” would match, but “Zásilkovna - pickup” would not.

Fix: Use the shortest distinctive term that uniquely identifies the carrier, like zasilkovna or packeta.

Mistake 4: Wrong carrier keyword field

On the Premium plan, each carrier has its own keyword field in the Interface Settings. Make sure you’re entering the keyword in the correct carrier’s field.

Mistake 5: Shipping method name changed after configuration

If you rename a shipping method in Shopify after setting up the keyword, the keyword may no longer match.

Fix: After renaming shipping methods, always verify that your keywords still match the new names.

Caution

If no keyword matches the customer’s selected shipping method, the widget will default to Zásilkovna. This means customers might see a Zásilkovna pickup point selector even when they chose a DPD or GLS method — if the DPD/PPL keyword isn’t configured correctly.

Keyword Examples by Carrier

Carrier	Example Shipping Method Names	Recommended Keyword
Zásilkovna	”Zásilkovna - výdejní místo”, “Zásilkovna Z-BOX”	zasilkovna
Packeta	”Packeta pickup”, “Packeta - výdejní místo”	packeta
GLS	”GLS ParcelShop”, “GLS - výdejní bod”	gls
DPD	”DPD Pickup”, “DPD ParcelShop”	dpd
PPL	”PPL ParcelShop”, “PPL - výdejní místo”	ppl
Balíkovna	”Balíkovna - výdejní místo”	balikovna

Verifying Your Configuration

After saving your keyword:

1. Go to your store’s checkout in a test session.
2. Select the shipping method that should trigger the widget.
3. Complete checkout and check the Thank You page — the widget should appear.
4. Check the order in Shopify admin — it should be tagged zasilkovna_unselected if the widget appeared but no point was selected.

If the widget still doesn’t appear, see the Troubleshooting guide.