Getting Started

This guide walks you through installing CZ Names, choosing a billing plan, and verifying that the app is processing your customers correctly.

Prerequisites

• A Shopify store with Czech-speaking customers
• Admin access to your Shopify store

Step 1 — Install the app

1. Open the Skloňování jmen listing on the Shopify App Store
2. Click Add app
3. Review the requested permissions and click Install app

The app requests the following permissions:

Permission	Why it’s needed
read_customers	Read customer first and last name to send for declension
write_customers	Write declined name forms back as customer metafields

Step 2 — Choose a billing plan

After installation, you are presented with the billing plan selection screen.

Plan	Price	For
Regular	$9.90 / month	All Shopify plans
Shopify Plus	$19.99 / month	Shopify Plus stores

The app detects your Shopify plan automatically. If you are on Shopify Plus, you will see the Plus plan pre-selected.

Both plans include a 14-day free trial — you will not be charged until the trial ends. You can cancel at any time during the trial without being billed.

Confirm your subscription to activate the app and start the trial.

Step 3 — Verify the app is running

After accepting billing, the app is immediately active. You can verify this by checking the app settings page, which shows your billing status and processing statistics.

Note

Existing customers are not automatically back-processed. The app processes customers on create or update events. To process an existing customer, make a small edit to their profile (for example, re-save their name) to trigger the webhook.

Step 4 — Test with a sample customer

The quickest way to verify everything is working:

1. Go to Customers in your Shopify admin
2. Create a test customer with a common Czech name, for example:
   • First name: Jana
   • Last name: Nováková
3. Save the customer
4. Wait a few seconds, then reload the customer profile
5. Scroll to the Metafields section and look for the czech-names-app namespace

You should see three metafields:

czech-names-app.addressing        → "Jano"
czech-names-app.last-name-addressing → "Novákové"
czech-names-app.gender            → "female"

Tip

If you don’t see the metafields immediately, wait 10–15 seconds and refresh. The declension API call is asynchronous and typically completes within a few seconds.

Step 5 — Configure templates (optional)

The app includes a template system that lets you combine the declined first and last name with gender-conditional text (for example, “Pane” vs “Paní”). See Name Templates for the full template syntax.

Step 6 — Add UI Extensions (optional)

The app ships with five UI Extension slots for the customer account portal and checkout flow. These display the addressing form wherever you embed them. To activate them, go to Online Store → Customize (or Checkout Editor) and add the CZ Names blocks to your desired sections.

Available extension slots:

Extension	Location
czech-names-profile	Customer account profile page
czech-names-order-index	Customer account order list
czech-names-order-status	Customer account order detail
czech-names-thankyou	Post-purchase thank-you page
czech-names-checkout-reductions-before	Checkout page (before reductions)

Next steps

• Use declined names in Liquid templates — email notifications, order confirmations, themes
• Set up Klaviyo integration — sync Czech data to Klaviyo profiles
• Customize name templates — gender-aware greeting formats