# HTML

> Translate HTML files and templates based on HTML

URL: https://store.crowdin.com/html
Identifier: html
Category: File Formats
Type: System
Author: Crowdin

HTML is a natively supported file format, you can use it without an additional installation. Just upload it to your projects and start the localization.

## Available Configurations


The HTML file format can be configured to optimize its use with Crowdin for better content handling. The following is a list of available configuration options.


- Enable content segmentation.

- Custom segmentation rules.

## File Format Details

| Attribute | Value |
| --------- | ----- |
| File Extension | .html, .htm, .xhtml, .xhtm |
| [API Type](https://developer.crowdin.com/api/v2/#operation/api.projects.files.post) | html |
| Source can be edited in Crowdin | No |
| Generating translated files via [Bundles](https://support.crowdin.com/bundles/) | [Search Crowdin Store](https://store.crowdin.com/tags/string-exporter) |
| Supports pluralization | No |
| WYSIWYG Preview in the editor | Yes |
| Supported types of contextual information | Text comments, Screenshots, In-Context |
| Custom attributes | No |
| Existing translations import possibility | ML-based technology |

## Sample File

```xml
<!DOCTYPE html>

<html lang="en">
  <head>
    <title>HTML Sample File</title>
    <meta charset="UTF-8">
    <link href="https://fonts.googleapis.com/css?family=Poppins:400,500" rel="stylesheet">
    <link href="https://fonts.googleapis.com/css?family=Noto+Sans+KR:400,500&amp;subset=korean" rel="stylesheet">
    <meta name="viewport" content="width=device-width, initial-scale=1">
  </head>

  <body>
    <div class="header">
      <h1>Crowdin HTML Sample</h1>
      <p>A <b>responsive</b> website created for testing purposes.</p>
    </div>
  </body>
</html>
```

## Translating HTML


**Working with HTML Entities**



Usually, in HTML files, texts enclosed in `&lt;` and `&gt;` entities don't require translation and are treated by Crowdin as HTML tags. Depending on the **HTML tags displaying** option selected in the Editor settings, they might be displayed in a simplified version (e.g., `<0>`) in the Editor for translators' convenience and copied into the translation. Although, occasionally, texts enclosed in `&lt;` and `&gt;` entities might require translation. In this case, as a possible way to proceed, you can replace `&lt;` and `&gt;` entities with the respective entity numbers (`&#60;` for `&lt;` and `&#62;` for `&gt;`) and update the source HTML files. As a result, translators will be able to see and translate the enclosed texts.



**Liquid Templates Localization**

This file importer is capable of localizing Liquid templates. Your Liquid templates should be uploaded with the .liquid file extension to allow Crowdin automatically detect it's content.



**Handlebars Templates Localization**

This file importer is capable of localizing Handlebars templates. Make sure your templates have .hbs extension so Crowdin can correctly select a proper configuration for import.