AgencyHandy

Central issue and enhancment

Onethread Handbook

Office Requirement and concerns

Check List

DevOps

KPI

Product Documentation

Explore

PRD

V1 Workspace Language

Product Requirements Document (PRD): Workspace Language for Agency Handy

Objective Enable multi-language support for Agency Handy workspaces to provide a localized user experience while maintaining a default language for notifications, emails, and custom domain integrations.

Business Need

Improved Accessibility: Allow agencies to cater to a global user base by supporting multiple languages.

Enhanced Usability: Provide users the flexibility to interact with the application in their preferred language.

Consistency: Ensure default language settings are applied consistently across notifications, emails, and custom domain integrations.

User Goals

Superadmins can manage workspace language preferences, including selecting and updating supported languages.

Users can interact with the application in their preferred language from a predefined list.

Maintain consistent language settings for communications sent outside the application, such as emails and custom domain content.

Functional Requirements

Language Management by Superadmin

Superadmin can select up to 5 languages from the predefined system language list.

Superadmin can set one of these languages as the default language for the workspace.

Default Language Application

The default language will apply to:

Default Notifications

Default Emails

Custom Domain Integrations

all the support texts/ tooltips

User Language Preferences

Users can select their preferred language from the list of languages enabled by the Superadmin.

Changing the user's language will affect only in-app content, including menus, labels, and tooltips.

Notifications, emails, and custom domain content will remain in the workspace's default language.

Localization Scope

Supported localization includes:

In-App Content: Menus, labels, tooltips, and prompts.

Emails and Notifications: Translated based on the default workspace language.

Language changes are user-specific and do not affect other users in the workspace.

Non-Functional Requirements

Scalability: Ensure the system supports adding more languages in the future.

Performance: Language switching should be instantaneous, with no significant load time increases.

Usability: Language selection and updates must be intuitive for Superadmin and end-users.

User Stories

As a Superadmin, I want to select up to five supported languages for my workspace so that users can interact in their preferred language.

As a Superadmin, I want to set a default language for notifications, emails, and custom domain integrations to ensure consistent communication.

As a user, I want to choose my preferred language from the list set by the Superadmin to interact with the application in my desired language.

User Flow

Superadmin Workflow

Navigate to the Workspace Settings section.

Select the Languages tab.

Choose up to 5 languages from the predefined system list.

Set one of the selected languages as the default.

Save the settings.

User Workflow

Navigate to User Settings.

Select the Language Preference option.

Choose a preferred language from the list provided by the Superadmin.

Save the selection to apply changes in the app interface.

Future Scope

Dynamic Translations: Incorporate real-time translation for user-generated content (e.g., comments, discussions).

Regional Formatting: Support for region-specific date, time, and currency formatting based on language settings.

Custom Translations: Allow Superadmins to add or modify specific translations for agency-specific terminology.

Acceptance Criteria

Language Selection

Superadmins can select up to 5 languages and set one as default.

Users can select a preferred language from the provided list.

Application Behavior

In-app content changes based on user-selected language.

Notifications, emails, and custom domain content remain in the default workspace language.

Localization Validation

Verify that all menus, labels, and tooltips reflect the selected language.

Ensure performance consistency during language switching.

Error Handling

Show an error message if the Superadmin tries to select more than 5 languages.

Default to the workspace language if a user-selected language is not supported.

This PRD outlines the steps to enable seamless multi-language support, ensuring a localized experience for users while maintaining consistency in external communications.

Want to print your doc?
This is not the way.

Try clicking the ⋯ next to your doc name or using a keyboard shortcut (

CtrlP

) instead.