# Quick Start This Quick Start Guide will walk you through the essential steps to get started with Transiyzi. ### Create a New Account To begin, you need to create a new account on Transiyzi. [Sign up](https://transiyzi.com/register) with your email address and set a password to access the platform. ### Create a New Project After creating your account, start a new project. Give your project a name, select the source language, and add any target languages for translation. You can find more information about projects by checking out the "Projects" documentation [here](/fundamentals/projects). This will provide you with a deeper understanding of how to manage and work with projects in Transiyzi. ### Upload Your Language Files Next, you need to upload the language files for your existing project to Transiyzi. There are three methods to do this: a) Upload directly through the platform: Navigate to the project dashboard, and click "Add" in the top right corner to upload your files. b) [Use the CLI tool](/developers/cli-command-line-interface): This is the best solution for uploading multiple language files at once. Follow the documentation to install and use the CLI tool. c) [Use the REST API](/developers/rest-api-reference): Integrate your project with Transiyzi's REST API to upload your language files programmatically. ### Begin Translating With your language files uploaded, you can now start translating your content. Collaborate with team members, suggest translations, and review and approve translations within the platform. ### Export Your Translations Once your translations are complete, you can export them in one of three ways: a) Download directly from the platform: Click the "Download" button in the project dashboard to get your translated files. b) Use the CLI tool: Follow the documentation to download your translated files using the CLI tool. c) Use the REST API: Leverage Transiyzi's REST API to download your translated files programmatically. By following these steps, you'll be able to quickly and efficiently use Transiyzi to manage your localization projects. # What is Transiyzi? Transiyzi is web-based software designed to simplify the complex and time-consuming process of localization management. With Transiyzi, product people, marketers, and software developers can centralize all their localization efforts, collaborate with translators seamlessly, and expand their global reach. The platform supports 25+ file formats, making it easy to import and export translations. {% hint style="info" %} Transiyzi comes from "**trans**lation" and the pronunciation of "easy" **(/i.zi/)**. {% endhint %} ### What can I do with Transiyzi? #### **With Transiyzi, you can:** * Translate the files used for localization. * Collaborate on and manage all of your software localization projects through a single platform. * Implement an agile workflow for localization. * Add screenshots to your projects to facilitate automatic recognition and string matching. * Configure automated workflows using an API, webhooks, or by integrating with other services. * Benefit from translation quality assurance. * Communicate accurately and instantly with your customers in their native tongue. #### Who is Transiyzi for? * **Developers:** By automating the translation and localization workflow, developers can reduce repetitive manual tasks. * **Product, project, and localization managers:** who want to accelerate the localization process and more efficiently manage all projects and teams from a single location. * **Translators:** Utilizing screenshots, comments, machine translation, in-context editors, and other tools, translators who desire to produce high-quality translations. # Integrations Enhance your Transiyzi experience by connecting to your favorite tools and existing workflows. * [CLI / Command-line interface](/developers/cli-command-line-interface) * [REST API](/developers/rest-api-reference) * GitHub (coming soon) * GitLab (coming soon) * Slack (coming soon) # White-label & Branding In Transiyzi, the White-label feature allows you to create a fully customized experience tailored to your brand. With White-label enabled, you can: 1. Use your own custom domain, making the platform feel like an extension of your website. 2. Upload your logo, ensuring that your branding is consistent throughout the platform. 3. Choose your own color scheme, aligning the platform's appearance with your brand identity. By customizing the platform, you create a seamless experience for your users, with registration, login pages, and emails all consistent with your brand. The White-label feature is available for administrators, who can begin customizing the platform by clicking on the "Company" page in the left-hand menu. To set up your custom domain, navigate to the "White-label" tab on the Company page, enter your domain, and follow the instructions to configure your CNAME record. With the White-label feature, you can create a unique, branded experience for your users, ensuring that your localization projects are always aligned with your brand's identity. # Setting Up a Custom Domain Transiyzi allows users to define their own domain names, providing a white-label experience. To set up a custom domain, follow these steps: {% hint style="info" %} **You must do this before moving on to the steps:** Create a CNAME record with your domain registrar and set its value to `proxy.transiyzi.com`. {% endhint %} In Transiyzi, 1. Click on "Company" in the left-hand menu. 2. Navigate to the "White-label" tab. 3. Click on "Setup a Custom Domain." 4. Enter your custom domain name. 5. Click "Add Custom Domain" button. *That's All.*

White-label: Custom Domain Assigning

By following these steps, you can successfully set up a custom domain in Transiyzi and enjoy a white-label experience tailored to your brand. # CLI / Command-line interface Transiyzi CLI lets you upload or download translations directly to your app, integrating with your build chain or CI/CD process. ### Installation The Transiyzi CLI is available on NPM repository as [transiyzi/transiyzi-cli](https://www.npmjs.com/package/@transiyzi/transiyzi-cli). #### Install using npm ```javascript npm install -g @transiyzi/transiyzi-cli ``` ### Usage Run **transiyzi --help** from the terminal to see the list of commands and subcommands. Run **transiyzi command --help** to see the help page. #### Commands
transiyzi init It is used to create the transiyzi.json file that holds your project settings. {% code title="transiyzi.json" overflow="wrap" lineNumbers="true" %} ```json { "access_token": "", "project_id": "", "base_path": "./resources/lang", "upload": { "locales": [] }, "download": { "default_format": "JSON", "include_unreviewed_translations": false, "aliases": {} } } ``` {% endcode %} * **access\_token** can be generated from the "Access Tokens" section in your profile settings. * After the **init** command, enter the access token and select from the list of authorized projects. * The **default\_format** selects the format for exporting non-file-specific keys during download from the given list. * The **base\_path** is the main directory where the language files are located, starting from the directory where the *transiyzi.json* file is located. For example: "./resources/lang". * NOTE: The path should not start from the OS root. * Incorrect usage: "/resources/lang".
transiyzi upload It reads the definitions in the **upload** **key** of the transiyzi.json file and performs an upload. * **The path** written represents the structure after the base\_path parameter. * **The locales** must match a language that exists in the project. When defining them, it is important to pay attention to the ISO code selected for the project, i.e., en !== en-US. * If the project can access files through a single structure, it should be defined as a string. If multiple templates are required, it should be defined as a string array. * The **\*\*** used in the path corresponds to any folder under the relevant folder. * The **\*** used in the path can be used to define the filename, foldername, or extension. * **The or statement** can be used in the path with the pipe symbol. Multiple formats can be defined this way. For example: **(php|json|xlsx)**. * **The locales.code** in the path corresponds to language code. * **update\_translations** in the API documentation corresponds to the same parameter in the import endpoint. Default value is false. * If a different variable other than is desired, the code\_alias parameter can be added to the locale object. An example is shown below. Now, \ === "English": {% code title="transiyzi.json" overflow="wrap" lineNumbers="true" %} ```json { "upload": { "locales": [ { "code": "en", "path": [ "**//**/*.(php|json)", "**/.(php|json)" ], "update_translations": true } ] } } ``` {% endcode %}
transiyzi download It reads the definitions in the **download key** of the transiyzi.json file and performs a download. * **format** in the API documentation corresponds to the same parameter in the import endpoint. Default value is null. * The **default\_format** in the API documentation corresponds to the same parameter in the download endpoint. Default value is JSON. * The **include\_unreviewed\_translations** in the API documentation corresponds to the same in the download endpoint. Default value is null. * The **aliases** parameter is used to make changes to the foldername or filename of downloaded files. In the example below, the downloaded file "./en/auth.php" is saved as "./default/auth.php" {% code title="" overflow="wrap" lineNumbers="true" %} ```json { "access_token": "", "project_id": "", "base_path": "./resources/lang", "upload": { "locales": [ { "code": "en", "path": [ "**//**/*.(php|json)", "**/.(php|json)" ], "update_translations": true } ] }, "download": { "default_format": "JSON", "include_unreviewed_translations": false, "aliases": { "en": "default", "es": "spanish", "de": "german" } } } ``` {% endcode %}
# REST API Reference The Transiyzi API allows you to retrieve updated translated content, modify it, or upload new content for translation. To get started, follow our documentation and POST your content for translation. You can continuously translate your content and GET your translations precisely when you need them. The usage of the API is free. {% hint style="info" %} To [obtain your token](/developers/obtaining-api-token), go to your profile settings and click on the "Access Tokens" section. Create a new token there and use it to access the API. {% endhint %} ### API Endpoints ## Export Languages `GET` `https://transiyzi.com/api/v1/export/locale` It exports your translations in the file format that you specify. #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | --------------------------- | | Authorization\* | String | Bearer: YOUR\_ACCESS\_TOKEN | #### Request Body | Name | Type | Description | | --------------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | project\_id\* | UUID | Your project ID. It can be found in the project settings. | | locale | String | If left blank, all project languages will be exported. The selection must be made from your project's languages, and the parameter must be sent in ISO-code format: en, en-US, tr, tr-TR. | | format | String | The language files are exported in the specified format here. | | default\_format | String | Default: JSON. The keys that are not associated with a file are exported in this format. | | include\_unreviewed\_translations | Boolean | Default: false. If true is sent, translations that have not yet been approved will be included in the export. | ## Import Languages `POST` `https://transiyzi.com/api/v1/import/locale` It is used to import existing translation files. #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | --------------------------- | | Authorization\* | String | Bearer: YOUR\_ACCESS\_TOKEN | #### Request Body | Name | Type | Description | | --------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | project\_id\* | UUID | Your project ID. It can be found in the project settings. | | file\* | String | The translation file to be imported. | | file\_name | String | The name and path of the file to be imported can be specified together. If not specified, the name of the uploaded file is used. For example: %LANG\_ISO%.php, test/test.json, vendor/nova/%LANG\_ISO%/validation.php. | | locale\* | String | The language of the file you want to import can be specified here. | | update\_translations | Boolean | Default: false. When set to true, existing translations for keys will be updated with the translations from the imported file. | ## List Projects `GET` `https://transiyzi.com/api/v1/projects` It lists your projects. #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | --------------------------- | | Authorization\* | String | Bearer: YOUR\_ACCESS\_TOKEN | ## List Languages `GET` `https://transiyzi.com/api/v1/projects/languages` It fetches the languages of the specified project. It can also be used to get their ISO codes. #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | --------------------------- | | Authorization\* | String | Bearer: YOUR\_ACCESS\_TOKEN | #### Request Body | Name | Type | Description | | --------------------------------------------- | ---- | --------------------------------------------------------- | | project\_id\* | UUID | Your project ID. It can be found in the project settings. | ## List File Formats `GET` `https://transiyzi.com/api/v1/file-types` It can be used to list the formats that can be used in the export endpoint. The 'key' field in the response should be used. #### Headers | Name | Type | Description | | ----------------------------------------------- | ------ | --------------------------- | | Authorization\* | String | Bearer: YOUR\_ACCESS\_TOKEN | # Supported File Types Transizyi supports a variety of file types for both uploading content for translation and exporting translated content. These file types are: | Key | Name | Extension | | --------------------- | ----------------------------- | ---------- | | JSON | JSON (.json) | json | | STRUCTURED\_JSON | Structured JSON (.json) | json | | JS | JavaScript Object (.js) | js | | PHP\_ARRAY | PHP Array (.php) | php | | PHP\_LARAVEL\_ARRAY | PHP Laravel Array (.php) | php | | INI | PHP INI (.ini) | ini | | YAML | YAML (.yaml) | yaml | | RUBY\_ON\_RAILS\_YAML | Ruby on Rails YAML (.yml) | yml | | PO | Gettext (.po) | po | | STRINGS | Apple Strings (.strings) | strings | | PROPERTIES | Java Properties (.properties) | properties | | ANDROID | Android Resources (.xml) | xml | | RESX | .NET Resource (.resx) | resx | | RESW | .NET Resource (.resw) | resw | | TS | Qt Linguist (.ts) | ts | | CSV | CSV (.csv) | csv | | XLSX | Excel (.xlsx) | xlsx | | MULTILINGUAL\_XLSX | Multilingual Excel (.xlsx) | xlsx | | ARB | Flutter (.arb) | arb | | APPLE\_XLIFF | Apple XLIFF (.xliff) | xliff | | PHP\_SYMFONY\_XLIFF | PHP Symfony XLIFF (.xliff) | xliff | | ANGULAR\_I18N\_XLIFF | Angular i18n XLIFF (.xlf) | xlf | | APPLE\_PROPERTY\_LIST | Apple Property List (.plist) | plist | | REACT\_NATIVE\_I18N | React Native (i18n) (.js) | js | # Libraries & SDKs {% hint style="warning" %} Our libraries and SDKs are not ready yet, but we are continuously working on them. If you have developed unofficial SDKs and would like them to be included on this page, please feel free to reach out to us through the chatbox below or on [Discord](https://discord.gg/ANMgXBqZ6r). We appreciate your contributions in advance. {% endhint %} # Obtaining API Token An API (Application Programming Interface) token is a unique identifier used for authentication when accessing an API. It is necessary because it allows secure communication between different software applications and ensures that only authorized users can access the API. In summary, an API token is important because it helps maintain security and control access to sensitive data and functionalities within an application.
Step 1: Click on your avatar at the bottom left corner and select Profile Settings.
Step 2: Navigate to "Access Tokens" from the top menu on the Profile Settings page. Click on the "Generate Token" button to create a new token.
Step 3: In the modal that shows up, enter a name for your token and choose what it can do. If you choose "read", it will only do download actions; if you choose "write", it will also do upload actions via API and CLI. Both scopes can be used together. Having a meaningful name for your token will allow you to easily find out which token is the computer, the server, the CI/CD, or the token you accidentally expose. Yeah. It sounds bad, but it happens.
Step 4: Copy the issued token. Done, and that's all. Tokens can only be seen once generated. So do not forget to save it to be able to use it. You can also edit the name and scope or revoke your token here.
# Projects This documentation explains the "Projects" section of Transiyzi. ## Introduction Projects are the area where new translation projects are created and managed. This documentation provides a step-by-step guide on how to create and manage a project. ## Accessing the Projects Section 1. On the main page of Transiyzi, find and click the "Projects" section in the left-side menu. ## Creating a New Project 1. On the "Projects" page, click the "Create New Project" button. 2. In the opened form, enter the name of your project. 3. Select an existing team or enter a new team name. 4. Choose the source language for your translations. 5. Click the "Create Project" button to save your new project. ## Uploading a Language File or Manually Entering Translations 1. Go to your newly created project. 2. Choose one of the following options: a. **Upload Language File**: Select the language file from your computer and click the "Upload File" button to upload the file. b. **Manual Translation Entry**: If you want to enter translations manually, click the "Enter Translation Manually" button and fill out the form with the texts and their corresponding translations. 3. Once the process is complete, click the "Save" button to save your translations. ## Additional Information * For each product, you can create separate translation projects or use a single translation project. * If your product has multiple clients, such as Android, iOS, or a web application, you can create separate projects for each of them. * After creating a project, you can change fields other than the source language by clicking the project settings icon. * You can activate the Machine Translation feature for your project in the project settings area as well. ## Conclusion The "Projects" section is one of the core features of Transiyzi. With this section, you can create new translation projects, manage your projects, and upload language files or manually enter translations. We hope that this documentation helps you work effectively with the projects section. # Teams This documentation focuses on the "Teams" section of Transiyzi. ## Introduction In Transiyzi, users are organized into teams to facilitate collaboration on translation projects. This documentation will provide an overview of the Teams section, its various features, and how to invite new members to a team. ## Overview of Teams In Transiyzi, users are organized into teams, and a user can belong to more than one team. Each team includes the following: * A list of team users * A list of invited users * A set of projects ## Accessing the Teams Section 1. On the main page of Transiyzi, find and click the "Teams" section in the left-side menu. ## Creating a New Team 1. On the "Teams" page, click the "Create New Team" button. 2. In the opened form, enter the name of your team. 3. Click the "Create Team" button to save your new team. ## [Inviting New Members to a Team](/fundamentals/teams/inviting-new-members-to-a-team) ## Managing Team Members and Roles 1. Go to the desired team page. 2. To manage existing team members, find the user in the list of team users and click the "Edit" button next to their name. 3. In the opened form, you can change the user's role or remove them from the team. 4. Click the "Save" button to confirm your changes. ## Conclusion The "Teams" section in Transiyzi is designed to help users collaborate on translation projects effectively. By organizing users into teams and assigning roles, you can ensure that your projects are managed efficiently and securely. This documentation provides a helpful overview of the Teams section, its features, and the process of inviting new team members. # Inviting New Members to a Team The "Inviting New Members to a Team" feature in Transiyzi refers to the process of adding new users to a collaborative group within the Transiyzi platform. This allows project owners or team administrators to extend access to the platform's resources, projects, and communication channels to new team members. The new members may be assigned specific roles, such as administrator, editor, or translator, depending on the requirements of the project. In summary, Transiyzi's "Inviting New Members to a Team" feature is essential for fostering collaboration, expanding the team, and ensuring the right people have access to the necessary tools and resources for successful localization projects. 1. Navigate to the "Teams" page. 2. Click the "Invite Collaborators" button in the top right corner. 3. In the panel that opens on the right side, enter the email address of the person you want to invite. 4. Select the team they will be part of and their role within the team (Admin, Editor, or Translator). 5. Click the "Send Invitation" button. 6. An email will be sent to the person, allowing them to join the team.
# Permissions & Roles Translators translate, editors approve the translations. Everything else is done by the admins. In order to make the experience as easy as possible, we kept the Roles very simple to avoid complicated permissions. There are 3 different Roles in Transiyzi teams: "Admin", "Editor", and "Translator". Below, I am detailing what each role can do: 1. Admin Role: * Invite new people to the team (or remove existing members) and promote them to the "Editor" or "Translator" role. * Approve translations that have been made. 2. Editor Role: * Invite new people to the team as "Translator". * Approve translations that have been made. (Proofreading) 3. Translator Role: * Suggest translations. The translation suggestions need to be approved. # Updating Team Member Roles When inviting individuals to a team, their roles are determined during the invitation process. To modify roles later, follow these steps: 1. Click on "Teams" in the left-hand menu. 2. Navigate to the team details page by clicking on the relevant team. 3. In the user table on the team details page, locate the row containing the user whose role you want to edit. 4. Click on the three dots at the end of the user's row and select "Edit Team Role." 5. Adjust the user's role as needed. This process allows you to easily manage and update team member roles within the platform.

Step 3

Step 5

# Languages This documentation focuses on the "Languages" section of Transiyzi. ## Introduction In Transiyzi, the Languages page contains the source language and target languages for your projects. This documentation will provide an overview of the Languages section, its features, and how to navigate and perform translations efficiently. ## Accessing the Languages Section 1. On the main page of Transiyzi, find and click the "Languages" section in the left-side menu. ## Languages Page Overview The Languages page displays your source language and target languages. You can start translating by entering one of the languages. ## Adding a New Target Language 1. On the Languages page, click the "Add New Language" button. 2. In the opened form, select the desired language from the dropdown list. 3. Click the "Add Language" button to save the new target language to your project. ## Uploading a Source File or Manually Entering Translations 1. On the Overview page, click the "Add" button located in the top right corner. 2. Choose one of the following options: a. **Upload Source File**: Click the "Upload File" button, select the source file from your computer, and click "Upload" to upload the file. b. **Manual Translation Entry**: Click the "Enter Translation Manually" button and fill out the form with the texts and their corresponding translations. 3. Click the "Save" button to save your translations. ## Quick Translation Area When you enter a language, the first area you encounter is the Quick Translation area. This area is divided into three tabs: 1. **Awaiting Translation**: Contains strings that are waiting for translation. 2. **Unreviewed**: Contains translations that have not been reviewed yet. 3. **All Translations**: Contains all the translations, both completed and pending. In the Quick Translation area, you can quickly and collectively perform translations and track missing translations without going into the details page of each translation. ## Downloading Translations (Admin) Admins can download translations from the Languages page. To do this, follow these steps: 1. On the Languages page, find the desired target language. 2. Click the "Download" button next to the language. 3. Choose the desired file format and click "Download" again to save the translated file to your computer. ## Conclusion The "Languages" section in Transiyzi is designed to help users manage and perform translations for their projects effectively. With the ability to add new target languages, upload source files or manually enter translations from the Overview page, and utilize the Quick Translation area, users can efficiently handle their localization tasks. We hope this documentation provides a helpful overview of the Languages section and its features. # Mappings This documentation focuses on the "Mappings" section of Transiyzi. ## Introduction In Transiyzi, the Mappings area is where you'll match the fields in your uploaded file with the source or target languages. This documentation will provide an overview of the Mappings section and how to use it effectively. ## Accessing the Mappings Section 1. After uploading your source or target language file, you will be automatically redirected to the Mappings area. ## Mappings Page Overview The Mappings page displays a table containing the fields from the uploaded file. Your task is to match these fields with the corresponding source or target languages.
### Matching Fields with Languages 1. Click on the header of the table column containing the fields you want to map. 2. Select the appropriate language from the dropdown menu to match the fields with the corresponding source or target language. ### Mapping Key Values to Source Language If your language file's key values are also your source language, follow these steps: 1. Click on the header of the table column containing the key values. 2. Instead of selecting "key" from the dropdown menu, choose your source language (e.g., English). By doing this, you'll map the key values to your source language. ## Conclusion The "Mappings" section in Transiyzi is designed to help users efficiently match the fields from their uploaded files with the corresponding source or target languages. Understanding and using the Mappings area effectively is crucial for ensuring accurate translations in your localization projects. We hope this documentation provides a helpful overview of the Mappings section and its functionalities. # Activities This documentation focuses on the "Activities" feature of Transiyzi. ## Introduction The Activities section provides an overview of translation suggestions, completed translations, approved translations, and comments in your projects. It is primarily used by admins to track project progress and activities. This documentation will provide an overview of the Activities feature and how to use it effectively. ## Accessing the Activities Section 1. On the main page of Transiyzi, click on your avatar in the left side menu, find the "Activities" link and click on it. ## Activities Page Overview The Activities page displays a comprehensive list of translation-related activities in your projects, including: * Translation suggestions submitted by users. * Completed translations. * Approved translations. * Comments on translations. ## Using the Activities Section Admins can use the Activities section to monitor the progress and activities of their projects, ensuring that translation tasks are being completed efficiently and effectively. By reviewing the Activities section, admins can: * Keep track of translation suggestions and their sources. * Identify which translations have been completed and which are still pending. * Review approved translations to ensure quality and consistency. * Read comments on translations to gather feedback and address concerns. ## Conclusion The "Activities" feature in Transiyzi is designed to help admins monitor and track the progress of their localization projects. By providing a comprehensive overview of translation-related activities, admins can ensure that their projects are progressing smoothly and that translations are being completed efficiently. We hope this documentation provides a helpful overview of the Activities feature and its functionalities. # Comments This documentation focuses on the "Comments" feature of Transiyzi. ## Introduction The Comments feature allows project team members to discuss and provide feedback on translations. All posted comments can be viewed by the entire team, facilitating communication and collaboration. This documentation will provide an overview of the Comments feature and how to use it effectively. ## Accessing the Comments Section 1. Navigate to a translation's details page within Transiyzi. 2. Click on the "Comments" tab located near the translation content. ## Comments Feature Overview In the "Comments" tab on the translation's details page, team members can leave comments, discuss translations, and provide feedback. ## Posting a Comment 1. In the "Comments" tab on the translation's details page, click on the text box labeled "Leave a comment." 2. Type your comment or feedback in the text box. 3. Press the "Enter" key or click the "Send" button to post your comment. The comment will be posted and visible to all team members. ## Viewing and Responding to Comments All team members can view and respond to comments in the Comments tab of a translation's details page. To respond to a comment: 1. Click on the text box labeled "Leave a comment" below the comment you wish to respond to. 2. Type your response in the text box. 3. Press the "Enter" key or click the "Send" button to post your reply. Your reply will be posted in the Comments section, allowing for organized and easy-to-follow discussions. ## Conclusion The "Comments" feature in Transiyzi is designed to foster collaboration and communication among project team members. By allowing users to leave comments and discuss translations, the Comments feature helps ensure the highest quality translations and a more efficient localization process. We hope this documentation provides a helpful overview of the Comments feature and its functionalities. # Contexts This documentation focuses on the "Context" feature of Transiyzi. ## Introduction The Context feature is designed to provide translators with a visual reference, showing where a specific translation is used within the project. This helps ensure more accurate and context-appropriate translations. This documentation will provide an overview of the Context feature and how to use it effectively. ## Accessing the Context Feature 1. Navigate to a translation's details page within Transiyzi. ## Context Feature Overview On the translation's details page, you'll find the "Context" section on the right-hand side. This is where you can upload a visual reference, such as a screenshot or image, to provide context for the specific translation. ### Uploading a Context Image 1. In the "Context" section on the translation's details page, click the "Upload Context" button. 2. A file picker window will open. Select an image in JPG or PNG format from your computer. 3. Click the "Open" button in the file picker window to start the upload process.
The image will be uploaded and displayed in the Context section, providing the translator with a visual reference for the translation. ## Conclusion The "Context" feature in Transiyzi is designed to help translators better understand where a specific translation is used within a project, enabling them to produce more accurate and context-appropriate translations. By allowing users to upload visual references, such as screenshots or images, the Context feature enhances the overall localization process. We hope this documentation provides a helpful overview of the Context feature and its functionalities. # Machine Translations We provide a few free Machine Translation credits for each company account created on Transiyzi. This enables the feature to be tested. After your free usage has been exhausted, to activate the Machine Translation feature, an API key must be created through [OpenAI GPT-3](/workflow-tools/machine-translations/openai-and-gpt-3), [Google Translate](/workflow-tools/machine-translations/google-translate), [Microsoft Translator](/workflow-tools/machine-translations/microsoft-translator), or [DeepL Translate](/workflow-tools/machine-translations/deepl-translate), and these keys must be entered in Transiyzi's "Project settings" based on which one is to be used. We recommend using GPT-3 for the best translations. *(You can learn how to create an API key by clicking on the relevant service.)*

Activating Machine Translations

In the future, Machine Translations can be used by purchasing credits directly on Transiyzi without the need for API keys. # OpenAI & GPT-3 OpenAI GPT-3 (Generative Pre-trained Transformer 3) is a language model developed by OpenAI that uses machine learning and artificial intelligence to generate human-like text. It is one of the most advanced language models currently available and can be used for a wide range of tasks such as language translation, content creation, and even writing code. GPT-3 has been trained on a massive corpus of text data, allowing it to generate highly accurate and coherent responses to a wide range of prompts. The model has 175 billion parameters, which is significantly more than any other language model that has been released to date. GPT-3 has received a lot of attention for its impressive capabilities, and its potential applications are wide-ranging. However, it's important to keep in mind that like any AI model, GPT-3 has limitations and biases, and it's important to carefully consider its use in various applications. {% hint style="warning" %} Note that the OpenAI GPT-3 API is a paid service and may have additional usage limits or billing requirements. Be sure to review the documentation for the API you're using to ensure you're following any usage guidelines or billing requirements. {% endhint %} ### How to create an API key for OpenAI GPT-3? 1. Go to the OpenAI website and sign up for a new account or sign in to your existing account. 2. Once you're signed in, navigate to the OpenAI API page and select "Apply for access". 3. Fill out the application form with your personal and company details, and provide a description of how you plan to use the API. 4. Once your application is approved, you will receive an email with instructions on how to create your API key. 5. Follow the instructions in the email to create your API key. 6. Your API key is now ready to use in your application. # DeepL Translate DeepL Translate is a machine translation service developed by the German company DeepL. It uses neural machine translation technology to provide highly accurate translations of text between 26 different languages. The service was launched in 2017 and has since gained popularity due to its high translation quality and intuitive interface. Unlike some other machine translation services, DeepL Translate offers context-specific translations, taking into account the context and meaning of the text, rather than simply translating word-for-word. DeepL Translate has also been praised for its ability to accurately translate idiomatic expressions and complex sentences. In addition to the translation service, DeepL also offers a number of other language-related tools, such as a dictionary and a document translation tool. While DeepL Translate is a paid service, it offers a free version with limited features for non-commercial use. {% hint style="warning" %} Note that some APIs, including the DeepL Translate API, may have additional usage limits or billing requirements. Be sure to review the documentation for the API you're using to ensure you're following any usage guidelines or billing requirements. {% endhint %} ### How to create an API key for DeepL Translate? 1. Go to the DeepL API Developer Dashboard and sign up for a new account or sign in to your existing account. 2. Once you're signed in, navigate to the DeepL API Dashboard and select "Create new API plan". 3. Select the plan that best fits your needs, and enter a name for your new plan. 4. Choose your billing method and enter your payment details, if necessary. 5. Once your plan is created, click on the "Generate new API key" button. 6. A new API key will be generated for you. Copy this key to use in your application. 7. Your API key is now ready to use in your application. # Microsoft Translator Microsoft Translator is a free online translation service provided by Microsoft. It allows users to translate text, speech, images, and even entire websites from one language to another. The service uses machine learning and statistical models to analyze and translate input text, taking into account the context and the grammatical structure of the source language. The service supports over 70 languages, and users can access it through the Microsoft Translator website, mobile apps, or a browser extension. Microsoft Translator also offers APIs for developers to integrate translation capabilities into their own applications. The service has become a useful tool for individuals and businesses to communicate with people who speak different languages and to access information in foreign languages. However, it's important to keep in mind that while the service can provide useful translations, its accuracy may not always be 100%, and it's still recommended to use human translation for important or sensitive documents. {% hint style="warning" %} Note that some APIs, including the Microsoft Translator API, may have additional usage limits or billing requirements. Be sure to review the documentation for the API you're using to ensure you're following any usage guidelines or billing requirements. {% endhint %} ### How to create an API key for Microsoft Translator? 1. Go to the Azure Portal and sign in or create a new account if you don't already have one. 2. Once you're signed in, navigate to the Azure Portal dashboard and select your subscription. 3. In the Azure Portal, search for "Cognitive Services" in the search bar at the top of the screen and click on the service. 4. Click on the "+ Add" button to create a new Cognitive Services resource. 5. Select the "Translator" option from the list of available APIs. 6. Enter a unique name for your resource and select the pricing tier that fits your needs. 7. Select a subscription and a resource group for your new resource, or create a new one. 8. Choose the location for your new resource and select "Review + create". 9. Review your configuration options and click on "Create" to create your new resource. 10. Once your resource has been created, navigate to your resource dashboard and select "Keys and Endpoint". 11. In the "Keys and Endpoint" section, you will see two keys, one for the "Primary Key" and one for the "Secondary Key". You can copy either key to use in your application. 12. Your API key is now ready to use in your application. # Google Translate Google Translate is a free online translation service provided by Google. It uses machine learning algorithms and statistical models to analyze and translate text, speech, images, and even entire websites from one language to another. The service supports over 100 languages and can be accessed through the Google Translate website, mobile apps, or a browser extension. It has become a popular tool for individuals and businesses to communicate with people who speak different languages and to access information in foreign languages. However, it's important to keep in mind that while the service can provide useful translations, its accuracy may not always be 100%, and it's still recommended to use human translation for important or sensitive documents. {% hint style="warning" %} Note that some APIs, including the Google Translate API, may have additional usage limits or billing requirements. Be sure to review the documentation for the API you're using to ensure you're following any usage guidelines or billing requirements. {% endhint %} ### How to create an API key for Google Translate? 1. Sign in to your Google Cloud Console account or create one if you don't have one already. 2. Once you're signed in, navigate to the Google Cloud Console dashboard and select your project. 3. From the left-hand menu, select APIs & Services > Credentials. 4. Click on the "Create credentials" button and select "API Key". 5. In the pop-up window, select "Server Key" if you want to restrict access to requests from a specific IP address, or select "Browser Key" if you want to allow requests from any client-side script. 6. Enter a name for your API key. 7. Click on the "Create" button to create your API key. 8. Your API key will now be displayed on the screen. You can copy the key to your clipboard by clicking on the "Copy" button. 9. Your API key is now ready to use in your application. # Suggestions This documentation focuses on the "Suggestions" feature of Transiyzi. ## Introduction Suggestions allow translators to propose translations for texts that need to be translated. These translations must be reviewed and approved by an editor or admin before they can be used, ensuring accuracy, appropriateness, and consistency with the brand's tone and voice. The concept is also known as "proofreading." This documentation will provide an overview of the Suggestions feature and its benefits. ## Suggestions Overview When a translator submits a translation, it is added as a suggestion. Admins and editors can easily filter and review unapproved translations, allowing them to quickly take action. Unapproved translations are also available for export via CLI, API, or manual download if desired. Machine Translations are added as suggestions by default, giving editors and admins the opportunity to review and approve them before incorporating them into the project. ## Benefits of the Suggestions Feature The Suggestions feature offers several advantages: * It promotes collaboration among team members, as translators can suggest translations and receive feedback from editors and admins. * It ensures the quality of translations by requiring review and approval before they can be used in the final product. * It allows admins and editors to quickly identify and approve outstanding translations, streamlining the localization process. * It provides the option to export unapproved translations for use in other contexts or projects. ## Conclusion The "Suggestions" feature in Transiyzi is designed to enhance collaboration, streamline the approval process, and ensure the quality of translations. By allowing translators to suggest translations and requiring review and approval from editors or admins, the Suggestions feature helps maintain consistency and accuracy in the final product. We hope this documentation provides a helpful overview of the Suggestions feature and its functionalities. {% hint style="info" %} Proofreading is important because it helps to catch errors and inaccuracies in translations. Accurate translations are essential for businesses to communicate with their target audience effectively. Poorly translated content can lead to confusion, frustration, and even mistrust among potential customers. On the other hand, accurate translations can help build trust and engagement with your target audience. {% endhint %} # Versions This documentation focuses on the "Versions" feature of Transiyzi. ## Introduction The Versions feature stores previous versions of translations, allowing users to access and restore them if needed. It serves as a log of translation changes, making it easier to track and manage updates. This documentation will provide an overview of the Versions feature and its importance. ## Accessing the Versions Section 1. Navigate to a translation's details page within Transiyzi. 2. Click on the "Versions" tab located near the translation content. ## Versions Feature Overview The "Versions" tab on the translation's details page displays a list of all previous versions of the translation. Each entry includes information about when the translation was last updated, allowing users to keep track of changes and updates. ## Restoring a Previous Version 1. In the "Versions" tab, locate the desired previous version of the translation. 2. Click the "Restore" button next to the version you wish to restore. 3. Confirm your selection in the prompt that appears. The selected version will replace the current translation, effectively reverting to the previous version. ## Importance of the Versions Feature The Versions feature is important for several reasons: * If an update inadvertently overwrites a previous translation, the Versions feature allows users to easily restore the older version. * By storing a log of translation updates, the Versions feature helps teams track changes and maintain version control over their localization projects. ## Conclusion The "Versions" feature in Transiyzi is designed to help teams manage and track updates to their translations. By storing previous versions and providing the ability to restore older translations, the Versions feature ensures that teams can maintain control over their localization projects and avoid losing valuable translation work. We hope this documentation provides a helpful overview of the Versions feature and its functionalities. # Votes This documentation focuses on the "Voting" feature of Transiyzi. ## Introduction The Voting feature allows team members to rate each other's translations, providing valuable feedback to editors or proofreaders responsible for the project. This documentation will provide an overview of the Voting feature and how to use it effectively. ## Accessing the Voting Feature 1. Navigate to a translation's details page within Transiyzi. 2. Locate the "Suggestions" section, which displays suggested translations for the current entry. ## Voting on a Suggested Translation To vote on a suggested translation: 1. In the "Suggestions" section on the translation's details page, find the suggested translation you'd like to vote on. 2. Click the "Thumbs up" icon located in the bottom right corner of the suggested translation. Your vote will be registered, and the total number of votes for that suggestion will be updated. ## Importance of the Voting Feature The Voting feature offers several benefits to the translation process: * It allows team members to provide feedback on each other's translations, fostering collaboration and improving translation quality. * The accumulated votes give editors and proofreaders a valuable reference point, helping them make informed decisions about which translations to approve. * By encouraging active engagement in the translation process, the Voting feature promotes a sense of ownership and responsibility among team members. ## Conclusion The "Voting" feature in Transiyzi is designed to enhance collaboration and improve the quality of translations. By allowing team members to vote on each other's translations, the Voting feature provides valuable feedback to editors and proofreaders, ensuring the best translations are chosen for the final product. We hope this documentation provides a helpful overview of the Voting feature and its functionalities. # Terms of Service By accessing the website at Transiyzi.com, you are agreeing to be bound by these terms of service, all applicable laws and regulations, and agree that you are responsible for compliance with any applicable local laws. If you do not agree with any of these terms, you are prohibited from using or accessing this site. The materials contained in this website are protected by applicable copyright and trademark law. MONEO operates the website Transiyzi.com – henceforth referred to as “Transiyzi”. #### Use License 1. Permission is granted to temporarily download one copy of the materials (information or software) on Transiyzi's website for personal, non-commercial transitory viewing only. This is the grant of a license, not a transfer of title, and under this license you may not: 1. modify or copy the materials; 2. use the materials for any commercial purpose, or for any public display (commercial or non-commercial); 3. attempt to decompile or reverse engineer any software contained on Transiyzi's website; 4. remove any copyright or other proprietary notations from the materials; or 5. transfer the materials to another person or “mirror” the materials on any other server. 2. This license shall automatically terminate if you violate any of these restrictions and may be terminated by Transiyzi at any time. Upon terminating your viewing of these materials or upon the termination of this license, you must destroy any downloaded materials in your possession whether in electronic or printed format. #### Disclaimer 1. The materials on Transiyzi's website are provided on an ‘as is’ basis. Transiyzi makes no warranties, expressed or implied, and hereby disclaims and negates all other warranties including, without limitation, implied warranties or conditions of merchantability, fitness for a particular purpose, or non-infringement of intellectual property or other violation of rights. 2. Further, Transiyzi does not warrant or make any representations concerning the accuracy, likely results, or reliability of the use of the materials on its website or otherwise relating to such materials or on any sites linked to this site. #### Limitations In no event shall Transiyzi or its suppliers be liable for any damages (including, without limitation, damages for loss of data or profit, or due to business interruption) arising out of the use or inability to use the materials on Transiyzi's website, even if Transiyzi or a Transiyzi authorized representative has been notified orally or in writing of the possibility of such damage. Because some jurisdictions do not allow limitations on implied warranties, or limitations of liability for consequential or incidental damages, these limitations may not apply to you. #### Accuracy of Materials The materials appearing on Transiyzi's website could include technical, typographical, or photographic errors. Transiyzi does not warrant that any of the materials on its website are accurate, complete or current. Transiyzi may make changes to the materials contained on its website at any time without notice. However Transiyzi does not make any commitment to update the materials. #### Links Transiyzi has not reviewed all of the sites linked to its website and is not responsible for the contents of any such linked site. The inclusion of any link does not imply endorsement by Transiyzi of the site. Use of any such linked website is at the user’s own risk. #### Modifications Transiyzi may revise these terms of service for its website at any time without notice. By using this website you are agreeing to be bound by the then current version of these terms of service. We are constantly changing and updating our services – notable changes to the terms will be added to a changelog on this page. Last modified Jan 27, 2023 #### Return or Refund If you live in the EU, UK, or Turkey, you’re eligible for a refund if you cancel your Transiyzi Pro or Enterprise plan subscription within 14 days of purchase. To request a refund, [contact support](mailto:hello@transiyzi.com) for assistance. #### Governing Law Except to the extent any applicable law provides otherwise, these terms and conditions are governed by and construed in accordance with the laws of San Francisco County, California and you irrevocably submit to the exclusive jurisdiction of the courts in that State. # Privacy Policy Your privacy is critically important to us. At Transiyzi, we have a few fundamental principles: * We don’t ask you for personal information unless we truly need it. * We don’t share your personal information with anyone except to comply with the law, develop our products, or protect our rights. * We don’t store personal information on our servers unless required for the on-going operation of the service. If you have questions about deleting or correcting your personal data please contact support. MONEO operates the website Transiyzi.com – henceforth referred to as “Transiyzi”. It is Transiyzi's policy to respect your privacy regarding any information we may collect while operating our websites. #### Website Visitors Like most website operators, Transiyzi collects non-personally-identifying information of the sort that web browsers and servers typically make available, such as the browser type, language preference, referring site, and the date and time of each visitor request. Transiyzi's purpose in collecting non-personally identifying information is to better understand how Transiyzi's visitors use its website. From time to time, Transiyzi may release non-personally-identifying information in the aggregate, e.g., by publishing a report on trends in the usage of its website. Transiyzi also collects potentially personally-identifying information like Internet Protocol (IP) addresses for logged in users. #### Gathering of Personally-Identifying Information Certain visitors to Transiyzi's websites choose to interact with Transiyzi in ways that require Transiyzi to gather personally-identifying information. The amount and type of information that Transiyzi gathers depends on the nature of the interaction. For example, we ask visitors who sign up to provide an email address via Google, Transiyzi's authentication provider. Those who engage in transactions with Transiyzi are asked to provide additional information, including as necessary the personal and financial information required to process those transactions. In each case, Transiyzi collects such information only insofar as is necessary or appropriate to fulfill the purpose of the visitor’s interaction with Transiyzi. Transiyzi does not disclose personally-identifying information other than as described below. And visitors can always refuse to supply personally-identifying information, with the caveat that it may prevent them from engaging in certain website-related activities. #### Aggregated Statistics Transiyzi may collect statistics about the behavior of visitors to its websites. For instance, Transiyzi may monitor the most popular pages viewed, or what actions visitors take most frequently. Transiyzi may display this information publicly or provide it to others. However, Transiyzi does not disclose personally-identifying information other than as described below. #### Protection of Certain Personally-Identifying Information Transiyzi discloses potentially personally-identifying and personally-identifying information only to those of its employees, contractors and affiliated organizations that (i) need to know that information in order to process it on Transiyzi's behalf or to provide services available at Transiyzi's websites, and (ii) that have agreed not to disclose it to others. Some of those employees, contractors and affiliated organizations may be located outside of your home country; by using Transiyzi's websites, you consent to the transfer of such information to them. Transiyzi will not rent or sell potentially personally-identifying and personally-identifying information to anyone. Other than to its employees, contractors and affiliated organizations, as described above, Transiyzi discloses potentially personally-identifying and personally-identifying information only in response to a subpoena, court order or other governmental request, or when Transiyzi believes in good faith that disclosure is reasonably necessary to protect the property or rights of Transiyzi, third parties or the public at large. If you are a registered user of the Transiyzi website and have supplied your email address, Transiyzi may occasionally send you an email to tell you about new features, solicit your feedback, or just keep you up to date with what’s going on with Transiyzi and our products. We primarily use our various product blogs to communicate this type of information, so we expect to keep this type of email to a minimum. If you send us a request (for example via a support email or via one of our feedback mechanisms), we reserve the right to publish it in order to help us clarify or respond to your request or to help us support other users. Transiyzi takes all measures reasonably necessary to protect against the unauthorized access, use, alteration or destruction of potentially personally-identifying and personally-identifying information. #### Deletion of Personally-Identifying Information At any time a customer may request the deletion of their account and associated personally-identifying information. Transiyzi will return or delete a customer’s personal data, unless further storage of such personal data is required or authorized by applicable law. If return or destruction is impracticable or prohibited by law, rule or regulation, Transiyzi shall take measures to block such personal data from any further processing (except to the extent necessary for its continued hosting or processing required by law, rule or regulation) and shall continue to appropriately protect the personal data remaining in its possession, custody, or control. To request the deletion of your data, contact Transiyzi support. A confirmation response will be sent within 48 hours, and when applicable under the terms of this policy, data will be permanently deleted within 30 days. #### Cookies A cookie is a string of information that a website stores on a visitor’s computer, and that the visitor’s browser provides to the website each time the visitor returns. Transiyzi uses cookies to help Transiyzi identify and track users, their usage of Transiyzi website, and their website access preferences. Transiyzi visitors who do not wish to have cookies placed on their computers should set their browsers to refuse cookies before using Transiyzi's websites, with the drawback that certain features of Transiyzi's websites may not function properly without the aid of cookies. #### Business Transfers If Transiyzi, or substantially all of its assets, were acquired, or in the event that Transiyzi goes out of business or enters bankruptcy, user information would be one of the assets that is transferred or acquired by a third party. You acknowledge that such transfers may occur, and that any acquirer of Transiyzi may continue to use your personal information as set forth in this policy. #### Privacy Policy Changes Although most changes are likely to be minor, Transiyzi may change its Privacy Policy from time to time, and in Transiyzi's sole discretion. Transiyzi encourages visitors to frequently check this page for any changes to its Privacy Policy. Your continued use of this site after any change in this Privacy Policy will constitute your acceptance of such change. # FAQ
Available plans Transiyzi offers [three subscription plans](link:https://transiyzi.com/pricing) that provide different numbers of translations. All paid plans have unlimited projects, languages, words, and team members(collaborators). * **Free** * Translations: 500 * Basic support * **Pro** * Translations * 7500 * 15.000 * 30.000 * 60.000 * 120.000 * 240.000 * White-label * Priority support * **Enterprise** * Translations: Custom * Dedicated Customer Success Manager & SLAs
Payment methods Currently, credit cards and debit cards are the two accepted payment methods. A payment card must only be associated with a user. Card information is not shared between team members. Card information must be entered when placing an order, and it will be automatically saved for future purchases. Nobody can see your payment details. Every user who wants to place an order must provide card information. The invoices will be issued under the company's name. Changes to the payment card can be made in the subscriptions section.
Cancelling subscription To cancel your current plan, proceed to Profile settings > Subscriptions and click Cancel subscription. The subscription will remain active until the end of the agreed period.
Trial period If you want to test drive Transiyzi before purchasing a paid subscription, you can take advantage of our 14-day free trial. This trial enables you to utilize all Transiyzi features, normally available on the Pro plan only. #### Getting your free trial To grab it: * Proceed to the Signup[ page](https://transiyzi.com/register). * Enter your name, your email, and your password. No credit card is required! * Enter the verification code we sent via email. That's it! During the trial period, you can create translation projects, upload and download translation files, utilize our integrations, forward your domain, and much more. If you are happy with the service, you can upgrade to a [paid subscription](#available-plans) anytime by clicking on the Upgrade now link at the bottom of the screen.