What are Translations?
Translations let you customize customer-facing text in the Q&A widget. You can change labels, messages, and button text to match your brand and language.
Two ways to customize text
1. Settings (app admin)
- Customize messages, labels, and button text
- Changes apply to all products
- Available on Pro and Ultra plans
2. Theme editor (block settings)
- Customize labels when adding blocks to your theme
- Per-block customization
- Available on all plans
Customizing in Settings
Where to find it
- Go to Settings in the app admin
- Scroll to the Translations section
- Edit the fields you want to change
- Click Save
What you can customize
AI behavior (if AI is enabled)
- AI Submit Button Text — “Ask with AI” button
- Ask Human Prompt Text — Prompt when AI answer isn’t helpful
- Ask Human Button Text — Button to ask a human
- Bypass AI Link Text — Link to skip AI
- Suggested Answer Label — Label for AI suggestions
- AI Vote Prompt Text — Prompt for voting on AI answers
- AI Vote Thanks Text — Thank you message after voting
Form fields & messages
- Submitting Button Text — Text while submitting
- Success Message — Message after successful submission
- Error Message — Message if submission fails
- Character Limit Message — Message when character limit is exceeded (use {{limit}} for the limit)
Display widget
- Loading Questions Message — Text while loading
- Loading More Message — Text when loading more
- Search Placeholder — Placeholder in search box
- Load Error Message — Message if loading fails
- Asked By Prefix — Text before question author name
- Answered By Prefix — Text before answer author name
- Date Prefix — Text before date (e.g., “on”)
- Date Locale — Locale for date formatting (e.g., “en-US”, “es-ES”)
- Date Style — Date format style (short, medium, long, full)
- Helpful Button Label — Label for helpful vote button
- Voting State Label — Text while voting
- Voted State Label — Text after voting
How it works
- Leave a field blank to use the default text
- Enter custom text to replace the default
- Changes apply immediately after saving
- Custom text overrides defaults
Customizing in Theme Editor
Where to find it
- Go to Shopify Admin → Online Store → Themes
- Click Customize on your active theme
- Go to a product page
- Add or edit the “Product Q&A” blocks
- Customize labels in block settings
Available blocks
1. Q&A Ask Form Block
Customize:
- Title — Block heading
- Question Label — Label for question field
- Name Label — Label for name field
- Email Label — Label for email field
- Submit Text — Submit button text
- Ask Modal Title — Modal heading (if using modal)
- Modal Question Label — Question label in modal
- Modal Name Label — Name label in modal
- Modal Email Label — Email label in modal
- Modal Submit Text — Submit button text in modal
2. Q&A Questions Display Block
Customize:
- Title — Block heading
- Ask Button Text — Text for “Ask Question” button
- Ask Modal Title — Modal heading
- Modal Question Label — Question label in modal
- Modal Name Label — Name label in modal
- Modal Email Label — Email label in modal
- Modal Submit Text — Submit button text in modal
How it works
- Each block has its own settings
- Changes apply only to that block instance
- You can have different text for different blocks
- Settings override app defaults
Best practices
1. Consistency
- Use consistent terminology across blocks
- Match your brand voice
- Keep messages clear and concise
2. Language
- Use your store’s language
- Consider date locale for international stores
- Test date formatting with your locale
3. Testing
- Preview changes before publishing
- Test on different devices
- Check all messages appear correctly
4. Defaults
- Leave fields blank to use defaults
- Only customize what you need
- Easier to maintain
Frequently asked questions
Do I need to customize everything?
No. Only customize what you want to change. Leave fields blank to use defaults.
Can I use different languages?
Yes. Enter text in any language. Set Date Locale for proper date formatting.
What happens if I leave a field blank?
The default English text is used.
Can I use HTML in translations?
No. Translations are plain text. HTML is only supported in email templates (separate feature).
Do changes apply immediately?
Yes. After saving in Settings, changes appear on your storefront immediately.
Can I customize per product?
No. Settings apply to all products. Use Theme Editor block settings for per-block customization.
What’s the difference between Settings and Theme Editor?
- Settings: Applies to all products, requires Pro/Ultra plan
- Theme Editor: Per-block customization, available on all plans
Can I reset to defaults?
Yes. Clear the field and save. The default text will be used again.
What date locales are supported?
Any valid locale code (e.g., “en-US”, “es-ES”, “fr-FR”, “de-DE”). Leave blank to use the shopper’s browser locale.
What date styles are available?
- Short — Brief format (e.g., “1/15/24”)
- Medium — Standard format (e.g., “Jan 15, 2024”)
- Long — Full format (e.g., “January 15, 2024”)
- Full — Complete format (e.g., “Monday, January 15, 2024”)
Can I use variables in translations?
Yes, in Character Limit Message use {{limit}} to show the character limit. Other variables are only available in email templates.
Do translations work with AI features?
Yes. If AI is enabled, you can customize all AI-related text in Settings.
Can I customize error messages?
Yes. Customize “Error Message” and “Load Error Message” in Settings.
What if I have multiple blocks?
Each block can have different settings. Customize each block separately in Theme Editor.
Quick reference
Settings translations
| Category | Available Fields |
|---|---|
| AI Behavior | Submit button, prompts, labels, vote messages |
| Form Messages | Submitting, success, error, character limit |
| Display Widget | Loading, search, error, author prefixes, date settings, vote labels |
Theme Editor blocks
| Block | Customizable Labels |
|---|---|
| Q&A Ask Form | Title, question label, name label, email label, submit text, modal labels |
| Q&A Display | Title, ask button text, modal title, modal labels |
Examples
Example 1: Spanish translations
Settings:
- Success Message: “¡Gracias! Tu pregunta ha sido enviada exitosamente.”
- Asked By Prefix: “Preguntado por”
- Answered By Prefix: “Respondido por”
- Date Locale: “es-ES”
Example 2: Custom button text
Theme Editor:
- Submit Text: “Enviar Pregunta”
- Ask Button Text: “Hacer una Pregunta”
Example 3: Branded messages
Settings:
Error Message: “Oops! Something went wrong. Please try again.”
Success Message: “Thanks for your question! Our team will review it shortly.”