Title: Cart Bridge JP – Migrate for WooCommerce
Author: Artisan-Workshop
Published: October 23, 2026
Last modified: October 23, 2026
---
Search plugins
# Cart Bridge JP – Migrate for WooCommerce
By [Artisan-Workshop](https://profiles.wordpress.org/artisan-workshop-1/)
[Download](https://downloads.wordpress.org/plugin/cart-bridge-jp.1.0.1.zip)
* [Details](https://wordpress.org/plugins/cart-bridge-jp/#description)
* [Reviews](https://wordpress.org/plugins/cart-bridge-jp/#reviews)
* [Installation](https://wordpress.org/plugins/cart-bridge-jp/#installation)
* [Development](https://wordpress.org/plugins/cart-bridge-jp/#developers)
[Support](https://wordpress.org/support/plugin/cart-bridge-jp/)
## Description
Cart Bridge JP moves product data between Color Me Shop (カラーミーショップ), a
Japanese e-commerce platform, and WooCommerce: categories, groups, products with
their options and images, and stock. Preview the whole migration first with a dry
run that writes nothing, read why each item would be skipped or changed, then run
it.
This plugin does not migrate customers, orders, or coupons. They are migrated by
a separate add-on, Cart Bridge JP Pro (see the FAQ).
It is built for a one-way migration: from Color Me Shop to WooCommerce, or from
WooCommerce to Color Me Shop. It is not a sync tool, and moving the same items back
and forth is not supported. If that happens by mistake, items that were imported
from Color Me Shop are not exported to Color Me Shop, and items that were created
in Color Me Shop by an export are not overwritten by a later import, which keeps
values from being changed in the usual cases.
#### Import from Color Me Shop
* Categories and groups (as product categories and product tags)
* Products, including options (as variations), prices including tax, the standard
and reduced tax rates, and images
* Stock
#### Export to Color Me Shop
* Products (including options) and stock
* Product image upload – **Beta**: needs the premium plan, has not been tested
on a real premium-plan shop yet, and is off by default
Color Me Shop cannot create categories through its API, so you map WooCommerce categories
to existing Color Me Shop categories in the Mappings tab instead.
#### Before and after the migration
* **Dry run**: preview every item, in both directions, without writing anything.
* **CSV report**: download the dry run’s results, with a plain-language cause for
each warning and, where possible, a fix.
* **Verification report**: after an import, compare the number of items read from
Color Me Shop with the linked items in WooCommerce, and find links to items that
no longer exist.
* **Tools**: rebuild the links to the data that this plugin imported (for example
after moving the database).
* Compatible with WooCommerce’s High-Performance Order Storage (HPOS).
* Long migrations run in the background with Action Scheduler, wait automatically
when the API’s rate limit is reached, and can be retried or cancelled.
#### Requirements
* WooCommerce 10.0 or later
* PHP’s sodium extension, which encrypts the saved credentials (most PHP builds
include it)
* A Color Me Shop store, and a developer app that you register yourself in Color
Me Shop’s developer center (the plugin shows the redirect URI to register)
* The shop owner’s Color Me Shop account to authorize the app (Color Me Shop does
not let sub-administrator accounts authorize apps)
#### External services
This plugin connects to the Color Me Shop API (`https://api.shop-pro.jp`), operated
by GMO Pepabo, Inc., only while you use it: when you connect your shop, test the
connection, open the Mappings tab (to list the shop’s categories), run a dry run,
an import, or an export, or use “Link and resolve” in the Export tab (to check that
an item exists in the shop).
* **What is sent**: your developer app’s client ID and client secret, the authorization
code, and your site’s callback URL (to `https://api.shop-pro.jp/oauth/token`,
to connect); the access token with every request; and, when you export, the data
you choose to export: products (such as names, prices, descriptions, options,
and stock), stock levels, and – if you turn on the Beta feature – product images.
* **What is read**: your shop’s settings (plan, tax settings), products, categories,
groups, and stock.
* **Images**: when you import products, categories, and groups, the plugin downloads
their images from the image URLs that the Color Me Shop API returns.
* The plugin sends no data to the plugin’s author or to any other service, and
has no tracking.
Color Me Shop API terms of use: https://api.shop-pro.jp/developers/tos
Color Me
Shop terms of service: https://shop-pro.jp/terms/colorme-terms/ GMO Pepabo privacy
policy: https://pepabo.com/company/privacy/
#### Trademarks
WooCommerce and its associated designs are trademarks of Automattic Inc. Color Me
Shop (カラーミーショップ) is a trademark of GMO Pepabo, Inc. This plugin is not
affiliated with or endorsed by Automattic Inc. or GMO Pepabo, Inc.
#### Source code
The JavaScript of the admin screens in `build/` is compiled from TypeScript, and
their CSS from `style.css`, with `@wordpress/scripts`. The source code is on GitHub:
https://github.com/artisanworkshop/cart-bridge-jp (this plugin is in `plugins/cart-
bridge-jp/`, and the TypeScript files and `style.css` of the admin screens are in
its `src/` directory). To build them, run `npm install` and then `npm run build`
in the root directory of the repository. The `vendor/` directory contains only the
Composer autoloader; the plugin has no third-party PHP packages.
## Screenshots
[⌊Connections: connect your Color Me Shop with your own developer app.⌉⌊Connections:
connect your Color Me Shop with your own developer app.⌉[
Connections: connect your Color Me Shop with your own developer app.
[⌊Import: the dry run's results, with counts and a CSV report for each kind of data.⌉⌊
Import: the dry run's results, with counts and a CSV report for each kind of data
.⌉[
Import: the dry run’s results, with counts and a CSV report for each kind of data.
[⌊Mappings: map WooCommerce categories to Color Me Shop categories for export.⌉⌊
Mappings: map WooCommerce categories to Color Me Shop categories for export.⌉[
Mappings: map WooCommerce categories to Color Me Shop categories for export.
[⌊Export: choose what to export. Product image upload is Beta and off by default.⌉⌊
Export: choose what to export. Product image upload is Beta and off by default.⌉[
Export: choose what to export. Product image upload is Beta and off by default.
[⌊Tools: rebuild the links to the data that this plugin imported.⌉⌊Tools: rebuild
the links to the data that this plugin imported.⌉[
Tools: rebuild the links to the data that this plugin imported.
## Installation
1. Install and activate WooCommerce, then install and activate this plugin.
2. Go to WooCommerce > Cart Bridge JP > Connections. Copy the callback URL shown there.
3. In Color Me Shop’s developer center, register a developer app and set its redirect
URI to that callback URL.
4. Enter the app’s client ID and client secret, save the settings, and click “Connect
to Color Me Shop”.
5. If you export, map WooCommerce categories to Color Me Shop categories in the Mappings
tab.
6. In the Import or Export tab, choose what to migrate and run a dry run first. Read
the warnings in the CSV report, then run the real migration.
## FAQ
### Can I keep the two stores in sync, or import and export the same items back and forth?
No. The plugin is built for a one-way migration. Items imported from Color Me Shop
are skipped when you export to Color Me Shop (warning `linked_by_import_not_exported`),
and items exported to Color Me Shop are not overwritten when you import from it (
warning `linked_by_export_not_imported`). This is decided per platform, not per
shop. It keeps values from being changed by a round trip in the usual cases, but
a round trip is not supported otherwise: for example, if the link to an exported
product is removed, importing creates the product again in WooCommerce.
### Can it migrate customers, orders, and coupons?
Not this plugin. Customers, orders, and coupons are migrated by a separate add-on,
Cart Bridge JP Pro, which is sold at https://wc.artws.info/ and is not available
from WordPress.org. This plugin works on its own for products, categories, groups,
and stock.
### What is the Beta feature?
Uploading product images uses a part of the Color Me Shop API that is available
only on the premium plan. It has been tested with mock data but not yet on a real
premium-plan shop, so it is marked Beta and is off by default (“Upload product images(
Beta)” in the Export tab). It appears only when the connected shop is on the premium
plan. Turning it on replaces the shop’s existing images at the same positions.
### The export skipped a product or a stock row with a warning. How do I fix it?
The dry run’s CSV report lists the warnings it finds for each item, with the cause
and, where possible, a fix. These are the most common warnings that stop an item
from being exported:
* `variation_stock_management_mixed` – The variations’ stock settings are mixed:
some manage stock and others do not, or variations that do not manage stock differ
in stock status (in stock and out of stock). A platform that manages stock per
product cannot represent this, so the product and its stock are not exported.**
Fix**: Turn on stock management for all variations, or turn it off for all variations
and give them all the same stock status (all in stock or all out of stock).
* `variation_any_attribute_unsupported` – A variation uses “Any” for an attribute,
which the platform cannot represent, so the product is not exported. **Fix**:
Replace the “Any” variation with one variation for each value of the attribute.
* `tax_class_unsupported` – The product’s tax class has no Japanese tax rate of
10% (standard) or 8% (reduced), so the product is not exported (it would be sold
with the wrong tax). **Fix**: Change the product’s tax class to the standard
or reduced rate, or give the tax class a Japanese tax rate: 10% (standard) or
8% (reduced). (The tax settings and the product’s tax fields are shown only when
tax calculation is turned on in WooCommerce > Settings > General.)
* `variation_tax_class_unsupported` – The tax class of a published variation has
no Japanese tax rate of 10% (standard) or 8% (reduced), so the product is not
exported. **Fix**: Change the variation’s tax class (or the product’s, if the
variation uses the same as its parent) to the standard or reduced rate, or give
the tax class a Japanese tax rate: 10% (standard) or 8% (reduced). (The tax settings
and the product’s tax fields are shown only when tax calculation is turned on
in WooCommerce > Settings > General.)
* `tax_status_not_taxable` – The product’s tax status is “Shipping only” or “None”,
which the platform cannot represent, so the product is not exported. **Fix**:
If the product is taxed, set its tax status to “Taxable”. Otherwise, add the
product on the platform by hand. (The tax settings and the product’s tax fields
are shown only when tax calculation is turned on in WooCommerce > Settings >
General.)
* `price_tax_basis_unresolved` – The price cannot be converted to a price including
tax: the tax class has tax rates, but none of them applies to the store’s address.
The product is not exported. **Fix**: Add a tax rate that applies to the store’s
address (or to all locations) to the tax class in WooCommerce > Settings > Tax,
or correct the store address.
* `product_price_invalid` – The product has no valid price, or its price cannot
be converted to a price including tax, so it is not exported. A simple product
needs a regular price; a variable product needs at least one enabled variation
with a price that is shown in the store. **Fix**: Set a regular price. For a
variable product, enable a variation with a price; if “Hide out of stock items”
is on, at least one variation must be in stock. If the product also has a warning
that its price cannot be converted to a price including tax, fix the tax rate
as that warning describes.
* `all_variations_excluded` – None of the product’s variations can be exported (
they are not enabled or have no valid price, or the product has no variations),
so the product is not exported. **Fix**: Enable at least one variation with a
valid price. The other warnings for this product show why each variation was
left out.
* `variation_axis_limit_exceeded` – The product uses three or more attributes for
variations, but the platform supports at most two, so the product is not exported.**
Fix**: Use at most two attributes for variations (combine attributes, or turn
off “Used for variations” on the others).
* `stock_product_not_exported` – The product or variation for this stock has not
been exported to the platform yet, so the stock is not exported. A full export
sends products before stock. **Fix**: Include products in the export. If the
product or this variation is not exported because of other warnings, fix those
first.
* `push_outcome_unconfirmed` – An earlier export of this item ended without confirming
whether it was created on the platform, so it is not sent again until you check.**
Fix**: In the Export tab, check whether the item exists on the platform, then
use “Link and resolve” or “Mark as not created”.
### In the CSV report, one warning says an item is exported and another says it is not. Which is right?
The report has one row for each warning, so an item with several warnings has several
rows, and each warning describes only its own check. The item’s result is in the`
operation` column (`created`, `updated`, or `skipped`), which is the same on all
of the item’s rows. Warnings whose `severity` is `blocking` are the ones that stop
an item; fix those first.
### How are product names with HTML handled?
Color Me Shop shows product names as HTML on the storefront. When you import, the
plugin saves the name as the storefront shows it: tags are removed and character
references (such as `&`) are turned back into characters. When you export, the
WooCommerce name is sent as it is, so a name that contains `<…>` is shown as HTML
by Color Me Shop.
### Does it work with High-Performance Order Storage (HPOS)?
Yes. The plugin declares HPOS compatibility. It does not read or write orders.
### What happens to my data when I uninstall the plugin?
The data that was migrated stays in WooCommerce. By default, the plugin’s own data(
the links between the stores, the job history, the logs, the saved connection, and
the settings) is also kept, so you can reinstall the plugin and continue.
To delete the plugin’s own data as well, turn on “Delete this plugin’s data when
it is uninstalled” in the Tools tab before you uninstall the plugin. Only users
who can delete plugins can change this setting. On a multisite network, deleting
the plugin from the Network Admin reads only the main site’s setting and deletes
only the main site’s data. Deactivating the plugin never deletes anything. Deleting
the saved connection does not revoke the app’s authorization in Color Me Shop, so
revoke it there if you no longer need it. If you install the plugin again after
its data was deleted, the links to the data that was imported can be restored with“
Rebuild links” in the Tools tab, but the links to the data that was exported cannot,
so exporting that data again creates duplicates in Color Me Shop.
## Reviews
There are no reviews for this plugin.
## Contributors & Developers
“Cart Bridge JP – Migrate for WooCommerce” is open source software. The following
people have contributed to this plugin.
Contributors
* [ Artisan-Workshop ](https://profiles.wordpress.org/artisan-workshop-1/)
* [ shohei.tanaka ](https://profiles.wordpress.org/shoheitanaka/)
[Translate “Cart Bridge JP – Migrate for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/cart-bridge-jp)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/cart-bridge-jp/), check
out the [SVN repository](https://plugins.svn.wordpress.org/cart-bridge-jp/), or
subscribe to the [development log](https://plugins.trac.wordpress.org/log/cart-bridge-jp/)
by [RSS](https://plugins.trac.wordpress.org/log/cart-bridge-jp/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 1.0.1
* First release on WordPress.org. It includes the changes listed under 1.0.0, which
was not published.
* Translations are not bundled with the plugin; WordPress installs them from translate.
wordpress.org as language packs. Until a Japanese language pack is available,
the plugin’s screens are shown in English on Japanese sites.
* The notices shown when a requirement is missing (WooCommerce is not active, the
PHP sodium extension is missing, or the plugin cannot load its dependencies)
now appear only on the Plugins screen and the Cart Bridge JP screen, instead
of on every admin screen.
#### 1.0.0
* Import categories, groups, products, and stock from Color Me Shop, and export
products and stock to Color Me Shop. Product image upload is Beta.
* If you used 0.1.0 from GitHub: the import is no longer limited to a sample. It
now includes every item, as the dry run already did.
* If you used 0.1.0 from GitHub: this plugin no longer migrates customers, orders,
or coupons. They are migrated by the separate add-on Cart Bridge JP Pro. The
customers, orders, and coupons that 0.1.0 imported stay in WooCommerce, and this
plugin does not change them.
* If you used 0.1.0 from GitHub: customers and orders that 0.1.0 imported may have
the wrong prefecture. For addresses in 23 of the 47 prefectures, 0.1.0 saved
a different prefecture (for example, Miyagi for an address in Akita). Importing
them again may not correct it, so check the prefecture (state) of those customers’
addresses and of those orders’ billing and shipping addresses, and correct it
by hand.
* If you used 0.1.0 from GitHub: if WooCommerce was installed in Japanese, its
reduced-rate tax class has a Japanese name, and 0.1.0 put reduced-rate (8%) products
in the standard tax class (the tax amounts of imported orders came from Color
Me Shop and are not affected). Importing them again may not correct it, so change
the tax class of those products to the reduced rate by hand.
* If you used 0.1.0 from GitHub: the plugin now asks Color Me Shop only for permission
to read and write products. Your existing connection keeps working with the permissions
it was given, which include customers, orders, and coupons. To withdraw them,
revoke the app’s authorization in Color Me Shop, then connect again.
* If you used a 0.x version from GitHub: imported product names are now saved as
Color Me Shop’s storefront shows them. A previously imported product whose name
contains tags or character references (such as `
` or `&`) may be updated
once by the next import, which also replaces changes you made to that product
in WooCommerce with the values from Color Me Shop.
## Meta
* Version **1.0.1**
* Last updated **1 week ago**
* Active installations **Fewer than 10**
* WordPress version ** 6.9 or higher **
* Tested up to **7.1.4**
* PHP version ** 8.2 or higher **
* Tags
* [export](https://wordpress.org/plugins/tags/export/)[import](https://wordpress.org/plugins/tags/import/)
[japan](https://wordpress.org/plugins/tags/japan/)[migration](https://wordpress.org/plugins/tags/migration/)
[woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
* [Advanced View](https://wordpress.org/plugins/cart-bridge-jp/advanced/)
## Ratings
No reviews have been submitted yet.
[Your review](https://wordpress.org/support/plugin/cart-bridge-jp/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/cart-bridge-jp/reviews/)
## Contributors
* [ Artisan-Workshop ](https://profiles.wordpress.org/artisan-workshop-1/)
* [ shohei.tanaka ](https://profiles.wordpress.org/shoheitanaka/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/cart-bridge-jp/)