Skip to content
Sounds Good Docs

FAQ

Why aren’t names being declined correctly?

Section titled “Why aren’t names being declined correctly?”

This is the most common issue. The app relies on a built-in Czech name dictionary to determine the correct vocative form.

Check the following:

  1. The customer’s first name field is populated in Shopify — the app cannot decline an empty field.
  2. The app has access to customer data (check permissions in Shopify Admin → Settings → Apps and sales channels → CZ Names).
  3. The name exists in the dictionary — uncommon or non-standard names may not have a match.

If a valid Czech name is not being declined, contact us with the specific name and we’ll investigate.

How do I use declined names in my emails?

Section titled “How do I use declined names in my emails?”

There are two main approaches:

  1. Liquid metafields — use {{ customer.metafields['czech-names-app'].addressing }} in Shopify email templates and notification templates. See Liquid Usage for full syntax and examples.
  2. Klaviyo integration — the app syncs declined names as Klaviyo profile properties (Czech addressing, Czech last name, Gender). See Klaviyo Integration for setup instructions.

For a complete walkthrough, start with the Getting Started guide.

Does it work with non-Czech names?

Section titled “Does it work with non-Czech names?”

The app is optimized for Czech names. Slovak names work in many cases due to linguistic similarity.

Non-Slavic names (English, German, Asian, Arabic, etc.) will typically not decline correctly. When the app cannot determine the correct declension of the first name, it writes no metafields at all — so there is no risk of displaying a garbled result, but your template needs a variant with no name in it.

Why is no declined name showing for a customer?

Section titled “Why is no declined name showing for a customer?”

This happens when the app cannot decline the name: the metafield is never created, so your template’s fallback runs instead. If that fallback contains customer.first_name you will see the nominative form (“Dobrý den, Lenka”); the fix is to drop the name from the fallback. Possible reasons the app cannot decline a name:

  • Name not in the dictionary — the name is too uncommon or non-Czech.
  • Name fails validation — names with hyphens, spaces, apostrophes, or non-Latin characters are marked as non-translatable. See Troubleshooting for the full validation rules.
  • Metafield not being read correctly — make sure you use bracket notation in Liquid: {{ customer.metafields['czech-names-app'].addressing }} (dot notation breaks because of the hyphen in the namespace).
  • Billing inactive — the app silently skips processing when billing is not active. Check your subscription status in Shopify Admin.

How do I test if declension is working?

Section titled “How do I test if declension is working?”
  1. Create a test customer (or use an existing one) with a known Czech name — for example, “Jan Novák” or “Petra Svobodová”.
  2. Trigger processing by editing and saving the customer profile in Shopify Admin.
  3. Open the customer profile and scroll to the Metafields section.
  4. Look for the czech-names-app namespace — you should see addressing, last-name-addressing, and gender fields populated.

If the metafields are empty, check the Troubleshooting page for common causes.

How do I grant you access to my store?

Section titled “How do I grant you access to my store?”

See our Collaborator Access guide for step-by-step instructions with video walkthrough.

Still need help?

Section titled “Still need help?”

Email us at integrace@soundsgood.agency — we typically respond within one business day.

Please include your store URL, the customer name causing the issue, and a screenshot of the metafields section on the customer profile if relevant.