Magento Community Project for providing best experience for Japanese market
Clone or download
ishakhsuvarov Merge pull request #59 from ishakhsuvarov/js-static
JavaScript Static Tess added to Circle CI
Latest commit 1f83f96 Jan 17, 2019

Magento 2 Japan

This repository contains set of modules required to provide a necessary user experience for Magento 2 at Japanese market.

Initial implementation of modules listed here provided by Veriteworks Inc.

Any Magento Community member are welcome to join to the project.

Goal: Adopt Magento 2 to Japanese market

Agile Board:

Slack: #japanese-localization

Release strategy: Modules from this repository will be available as separate extensions to Magento 2 with possibility to install them with Composer metapackage. All development targeted to Magento 2.3 and will be compatible with all further Magento releases.

If implementing some feature requires changes in Magento 2 core these changes should be delivered with pull request to magento/magento2-l10n and will be merged as soon as all tests are green and approved by reviewer. Contribution to magento/magento2 is also acceptable but in this case pull request will be processed in general queue.

Committing changes: It is highly encouraged for this project to create feature branches inside this repo. Any contributor should be able to do that.

Companion project: Repository magento/magento2-l10n should be used to deliver fixes to Magento core required by this project.

Installation from Git

To install Magento with Japanese modules please follow next steps:

  1. Clone this repository outside from Magento Open Source directory
git clone
cd magento2-jp
  1. Optionally, switch to feature branch
git checkout -b <local_branch> origin/<feature_branch>
  1. Clone main Magento 2 repository
cd ../
git clone
cd magento2
  1. Add repository with localization core improvements as remote repository and fetch data
git remote add l10n
git fetch l10n

Optionally, checkout local branch from l10n repository

git checkout -b <local_branch> l10n/<feature_branch>
  1. Link Magento 2 Japanese modules to Magento 2 Open Source
ln -s ../../../magento2-jp ./app/code/MagentoJapan

You may need to change file paths to match your setup

  1. Add app/code/MagentoJapan to local ignore list in Magento Open Source repository
echo "app/code/MagentoJapan" >> ./.git/info/exclude
  1. Now you have Magento Open Source code with Magento Japan modules ready to be installed as described at DevDocs.

If you already have Magento installed you need enable Japanese modules and upgrade your installation:

php bin/magento module:enable --all
php bin/magento setup:upgrade


To participate in the project and contribute you need to create local installation as described in section above.

We encourage to contribute to and by pushing your local changes to feature branch. Once feature or bugfix is completed or you would like to start communication on it please create pull requests from a feature branch to 2.3-develop branch.

If you don't have permissions to push new branch in or please contact Magento Community Engineering representative Volodymyr Kublytskyi by email or by private message in Magento Community Engineering Slack.

Optionally, you may fork repository and create pull requests from it.

We recommend not to fork and use a fork of main Magento Open Source repository ( instead.



Minimum Viable Product targeted to support Magento Open Source 2.3.x (with sample data) single store with ja_JP locale and JPY currency with following features:

  • #33 Full translations to Japanese
  • #34 Valid rounding of JPY currency
  • #35 Katakana for names
  • #36 Valid names format for storefront and admin (Lastname Firstname PolitnessSuffix)
  • #37 Perfectures (regions) listed in order from North to South
  • #38 Autocomplete of address fields based on ZIP code
  • #39 Possibility to configure store address from Admin Panel
  • #40 Valid configuration of ElasticSearch index (Kuromoji)
  • #41 Possibility to generate PDF files with Japanese multibyte characters
  • #30 Install with single composer dependency (e.g. magentojapan/common)

MVP optional features:

  • #42 Preset of configuration options (locale, currency, measurement units, etc.) applied during installation
  • #43 Cache on delivery as payment method (consider possibility to us MSP CacheOnDelivery module)
  • #44 Possibility to specify delivery time
  • Payment Methods (GMO Payment Gateway, Veritrans, Sony Payment Service)
  • Support of main delivery companies (Yamato, Sagawa)
  • Valid date format in admin