# Magento

> Translate Magento (Adobe Commerce) product descriptions, category properties, attributes, email template, pages and more

URL: https://store.crowdin.com/magento
Identifier: magento
Category: eCommerce
Type: App
Author: Magefan

Set up integration once, define your localization workflow, and spend less time managing translations.

> Magento is a modern cloud commerce platform with an open-source ecosystem.

## Features at a glance


 - Translate Products' descriptions, Categories, [Magento 2 Extensions](https://magefan.com/magento-2-extensions), Email templates, Pages, Attributes and more.
 - Manual content synchronization before and after translation.
 - Auto-sync of source content and translations.
 - WYSIWYG file preview for translators.
 - Quick sync and translation of even minor content updates, like a new sentence or a changed word.

### Adobe Commerce (Magento) translation connector overview

<div class="video"><iframe style="overflow:hidden; max-width: 68vw; max-height: 37.25vw;" height="100%" width="100%" src="https://www.youtube.com/embed/rPQY0058j4I" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen=""></iframe></div>

## Setting up the Magento translation connector


After installing the application, you will find it in your project's *Integrations* section.


Follow the instructions on the screen to connect your Magento account.

If your store is behind a firewall, allow requests from the Crowdin IP addresses listed under [Integrations and Applications](https://support.crowdin.com/developer/ip-addresses/#integrations-and-applications). The connector sends its requests to `/rest/V1/crowdin/` under the **API URL** you enter. On Cloudflare, add these addresses as **IP access rules** with the **Allow** action, so that Bot Fight Mode lets the requests through too.

![Magento translation with Crowdin](https://developers.app.crowdin.net/api/media/file/225c9f1c-8465-408d-9b1f-8d2f5eee404e.png "Magento configuration.")

## Manual synchronization


To import content for translation from Magento, follow these steps:


 1. Open the Magento integration.
 2. In the Magento section (right panel), select the files that should be translated.
 3. Click Sync.


To export translations to Magento, follow these steps:


 1. Open the Magento integration.
 2. In the left section, select the files that will be synced to Magento.
 3. Click Sync to Magento.

![Sync translated files to Adobe Commerce](https://developers.app.crowdin.net/api/media/file/e1d21b5f-644d-474c-8f98-a490c4d6d13f.png "Magento translation synchronization.")


## Auto content synchronization


To automatically import content for translation from Magento, choose files and click Scheduled sync in the right panel in the Magento integration. The file you choose will be pushed once at a scheduled time (by default, it is done once a day). The same button is used to export translated files from Crowdin to Magento (in the left panel). You may disable this by clicking Disable Sync.



## Installation


### Method I: Installing via Composer (recommended)

- Open the command line.
- Using the command "cd" navigate to your Magento 2 root directory.
- Run CLI commands:

```
composer require magefan/module-crowdin-integration
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
```


### Method II: Installing using an archive and FTP

- Download the Crowdin Integration Extension ZIP archive from the [magefan.com website](https://magefan.com/magento-2-crowdin-integration).
- Extract files.
- Copy the app folder from the archive to your Magento 2 folder.


![](https://developers.app.crowdin.net/api/media/file/71d48c29-fc41-489a-83f8-facaa120e7d1.png)


- In the command line, using "cd", navigate to your Magento 2 root directory.
- Run CLI commands:

```
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
```

Once you have installed the Magento 2 Crowdin Integration extension, you can start the extension configuration.


## Extension Configuration

### Synchronize Crowdin with Magento

To synchronize Crowdin with Magento, follow these steps:

- Navigate to *Stores* > *Configuration* > *Magefan Extensions* > *Crowdin Integration*.
- Enable the extension and click *Save*.
- Now we need to activate the Crowdin integration, click on *Activate Integration* link.

![](https://developers.app.crowdin.net/api/media/file/3bd47f06-59ad-42e6-b0b9-8de18a9914c9.png)

- The Magento Integration section will be opened. Here you need to find an integration named “crowdin” and click *Activate*.

![](https://developers.app.crowdin.net/api/media/file/fb7b5e73-937b-46d8-b5ad-3d3de9f805c0.png)

- Here you need to confirm the action by clicking *Allow* (all required permissions for the extension to work are already pre-set).

![](https://developers.app.crowdin.net/api/media/file/ee228fc3-ae4e-4d5c-bb59-7b51ba28e2cc.png)

- You have generated your Integration Tokens, no need to copy them, just click *Done* and go back to  *Configuration* > *Magefan Extensions* > *Crowdin Integration*.

![](https://developers.app.crowdin.net/api/media/file/0378a5e9-7be9-4031-b743-d62f6d720f78.png)

- Click *Copy Integration Key* and paste it into your Integration in Crowdin.

![](https://developers.app.crowdin.net/api/media/file/0337f9e3-0bdf-4f1f-ae1a-7ae7db3ea12b.png)


### Exclude Data From Synchronization 

If you need to exclude the product/category/cms page/cms block attribute from syncing, you can do so in the *Synchronize To Crowdin* section by selecting *No* for the desired attribute.

![](https://developers.app.crowdin.net/api/media/file/ba92d061-a15a-48a0-bef2-2e8f7cc2567d.png)


*Note*: If some fields won't be selected in mapping, they will be enabled by default. If you remove all mappings, all fields will be enabled to sync to Crowdin.


## Uninstallation

The file removal instructions depend on how the extension was installed.

- If you can find the extension files in the folder

```
app/code/Magefan/Crowdin
```

then remove this folder.



- If the extension was installed via Composer and its files are located in the folder

```
vendor/magefan/module-crowdin-integration
```

then run the Composer CLI command to remove it:

```
composer remove magefan/module-crowdin-integration
```


Once extension files have been removed, run these Magento CLI commands:

```
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
```


## Subscription

The free trial is 14 or 30 days, depending on your subscription plan.
