Translations
Override the default text labels used across your storefront and editor with custom per-store translations.
Translations lets you customize the text labels, button captions, and messages displayed on your storefront and in the Print Editor. PrintNow ships with a set of default resource strings (e.g., "Add to Cart", "Upload", "Confirm Delete") that are used across checkout, upload, cart, account, and registration pages. On this page you can override any default value with your own custom text on a per-store basis without modifying code.
The same translations module is used in two locations in the Unified Admin. Settings > Translations shows storefront translations (all keys). Products > Editor Translations shows only editor-specific translations (keys prefixed with Editor_). Both views use the same interface described below.
View Translations
- From your Unified Admin, go to Settings > Translations.
- The translation list displays all available resource keys in a paginated grid, sorted alphabetically by key.
- Use the Search panel to filter keys by name. The search is case-insensitive and matches partial key names.
- To edit a translation, click the action menu on any row and choose Edit. A dialog opens where you can set a custom value.
- To reset a translation back to the platform default, click the action menu and choose Reset. This deletes the per-store override so the default value is used again.
Translation List Columns
| Column | Description |
|---|---|
| Translation Key | The resource key identifier (e.g., ViewCart_ConfirmDelete_Text, Upload_Invalid_File_Size). This is the internal name used by the platform to look up the text. |
| Default Value | The built-in platform text for this key. This is what displays on the storefront when no custom override exists. Retrieved from the WebResources resource file. |
| User Value | Your custom override text for this store. When set, this value is displayed instead of the default. When blank, the default value is used. |
| Action | Menu with Edit and Reset options. |
Edit a Translation
- Click Edit from the action menu on any translation row.
- A dialog titled Update User Value opens with a single text area.
- Enter your custom text in the Value field. This field is required -- you cannot save an empty override (use Reset instead to clear an override).
- Click Save to apply the override. The User Value column updates immediately in the grid.
- Click Cancel to close the dialog without saving.
The override takes effect on the storefront after the next page load. No build or deployment is required.
How Translations Work
Translation keys are stored in a central SiteResources table shared across all storefronts. Each key has a default English value defined in a .NET resource file (WebResources.resx). When you set a custom User Value, PrintNow creates a SiteResourceMap record linking the resource key to your store with your custom text.
At runtime, the storefront checks for a store-specific override first. If one exists, it uses your custom value. If not, it falls back to the default from the resource file.
Associations
Print Store
| Area | Effect |
|---|---|
| Checkout pages | Labels and messages on the single-page checkout (cart, shipping, payment, information steps) are driven by translation keys. Overriding these keys changes the text customers see during checkout. |
| View Cart page | Button labels (e.g., Save button text) and confirmation messages (e.g., delete confirmation) use translation keys like ViewCart_ConfirmDelete_Text and CartItem_SaveButton_Text. |
| Upload page | Validation messages for file uploads (invalid file size, invalid file type) are controlled by translation keys like Upload_Invalid_File_Size and Upload_Invalid_File_Type. |
| Account pages | Self-registration, guest registration, password reset, My Account, and customer approval pages all reference translation keys for their labels and messages. |
| Product validation | Warning messages shown when products are removed or modified (e.g., removal header/footer text) come from translation keys. |
Print Editor
| Area | Effect |
|---|---|
| Editor UI labels | The Print Editor loads translations from the editor/api/translations endpoint at startup. All UI text in the editor (toolbar labels, panel headings, button text) is rendered through a translate pipe that looks up the translation key. Editor translation keys are prefixed with Editor_ and are managed via Products > Editor Translations in the admin. |
Related Pages
- General Settings — set the storefront culture/locale that determines default language
- Checkout Styles — customize the visual appearance of the checkout where translations display