CS-Cart EAN / UPC / GTIN
Barcode Add-on
GS1-compliant barcode management for CS-Cart and Multi-Vendor. Assign EAN-13, UPC-A and GTIN-14 identifiers to your products — with real-time checksum validation, bulk CSV import, label printing, and storefront display. Out of the box.
01 What it does
CS-Cart's built-in barcode addon only supports Code 128 and Code 39 — neither of which is accepted by major retail channels, Google Shopping, or logistics systems. EAN/UPC/GTIN Pro bridges that gap by extending the barcode generator with full GS1 standard support.
Every barcode is validated against the GS1 mod-10 checksum algorithm before it is saved — the same standard used by retail scanners worldwide. The addon integrates natively with CS-Cart's hook and EXIM systems so it survives core upgrades cleanly.
?:products — fast to query, filterable in product lists.Tygh\Tools\Barcode\Generator via a ServiceProvider — clean upgrade path.02 Barcode types
The addon adds three GS1 standard barcode types that CS-Cart does not support natively.
03 Requirements
| Requirement | Value | Notes |
|---|---|---|
| CS-Cart core version | ≥ 4.13.1 | Tested up to 4.20.1 |
| Supported editions | CS-Cart, Ultimate, Multi-Vendor | Auto-installs on MV and Ultimate |
| Required addon | barcode (built-in) | Must be active before installing |
| PHP | Any version CS-Cart supports | GD library required for barcode image generation |
| Database | MySQL / MariaDB | Adds 3 columns + 2 tables on install |
04 Installation
Ensure the native barcode addon is active
Go to Add-ons → Manage Add-ons and confirm the built-in Barcode addon status is Active. EAN/UPC/GTIN Pro depends on it.
Download and install
Purchase from the CS-Cart Marketplace, download the .zip, then go to Add-ons → Manage Add-ons → + and upload it.
Confirm installation
The addon creates three columns on ?:products (ean_code, upc_code, gtin_code) and two tables (?:ean_upc_gtin_history, ?:ean_upc_gtin_scans) automatically.
Configure settings
Click the gear icon next to the addon. Defaults work for most stores — review validation and Multi-Vendor settings if needed (see §05).
Assign barcodes
Open any product in the admin panel and find the new EAN / UPC / GTIN tab. Or use Bulk Import to assign barcodes to many products at once via CSV.
05 Settings
All settings are at Add-ons → Manage Add-ons → EAN/UPC/GTIN Pro → Settings.
Display
| Setting | Default | Description |
|---|---|---|
| Enable dashboard | Yes | Show the EAN/UPC/GTIN Pro dashboard in the Products menu. |
| Show barcode tab on product edit | Yes | Add a dedicated EAN / UPC / GTIN tab to every product edit page. |
| Show barcodes on storefront | Yes | Display barcode identifiers in the product features section on the storefront. |
| Show digits below barcode image | Yes | Print the barcode number as plain text below the barcode image. |
Barcode Generation
| Setting | Default | Description |
|---|---|---|
| Default barcode type | EAN-13 | Pre-selected type when generating a new barcode on the product edit page. |
| Barcode image height (px) | 60 | Height of the generated barcode image in pixels. |
| Barcode image width (px) | 250 | Width of the generated barcode image in pixels. |
Validation
| Setting | Default | Description |
|---|---|---|
| Validate GS1 mod-10 checksum | Yes | Validate the check digit when saving a product. Blocks save on invalid code. |
| Auto-calculate check digit | Yes | Automatically fill in the check digit when entering a partial barcode (e.g. 12 digits for EAN-13). |
| Warn on duplicate barcode | Yes | Show a non-blocking warning when a barcode is already assigned to another product. |
Multi-Vendor (MVE:ROOT only)
| Setting | Default | Description |
|---|---|---|
| Allow vendors to manage barcodes | Yes | Vendors can enter and edit EAN/UPC/GTIN codes on their own products. |
| Require admin approval | No | Barcode changes by vendors require administrator approval before being applied. |
| Show per-vendor coverage | Yes | Show a vendor-by-vendor barcode coverage breakdown on the dashboard. |
06 Product edit tab
When enabled, a new EAN / UPC / GTIN tab appears on every product edit page in the CS-Cart admin panel.
| Field | Description |
|---|---|
| EAN-13 | 13-digit international article number. Validated on input and blocked on save if checksum fails. |
| UPC-A | 12-digit North American barcode. Same validation rules as EAN-13. |
| GTIN-14 | 14-digit logistics identifier for case-level packaging. |
| Auto-generate button | Calculates and fills in the correct check digit from the digits you've entered — no manual calculation needed. |
| Barcode preview | Live barcode image rendered via CS-Cart's image.barcode endpoint as you type. |
| Change history | Timestamped log of every barcode change on this product, including which admin made the change. |
07 Admin dashboard
Navigate to Products → EAN/UPC/GTIN Pro → Dashboard for a store-wide overview.
| Panel | Shows |
|---|---|
| KPI cards | Total products, products with barcodes, missing barcodes count, scans today. |
| Coverage summary | Percentage of products that have EAN-13, UPC-A, and GTIN-14 respectively. |
| Scan activity chart | 30-day scan volume line chart — useful for spotting which products are being looked up most. |
| Barcode type distribution | Pie chart showing the breakdown of barcode types across your catalog. |
| Vendor coverage (MV) | Per-vendor table showing product count and coverage % for each marketplace vendor. |
| Quick actions | Shortcuts to Bulk Import, Manage Barcodes, View Missing, and Print Studio. |
08 Bulk import / export
Navigate to Products → EAN/UPC/GTIN Pro → Bulk Import / Export to assign barcodes to many products at once.
Export
Click Export CSV to download all products with their current EAN, UPC, and GTIN values. The CSV uses CS-Cart's native EXIM format — Product code as the identifier column.
Import
Export existing products
Use Export CSV to get the correct column format. Edit the EAN, UPC, and GTIN values in the downloaded file.
Upload the CSV
Click Import CSV and select your file. CS-Cart validates barcodes against GS1 mod-10 before importing.
Review validation results
Rows with invalid checksums are flagged with the specific error. Valid rows are imported; invalid rows are skipped with a report.
Done
CS-Cart updates all matching products. The dashboard immediately reflects the new coverage figures.
Product code (required, used to match products), EAN (13 digits), UPC (12 digits), GTIN (14 digits). Leave a cell empty to clear that field.09 Print labels
Navigate to Products → EAN/UPC/GTIN Pro → Print Labels. Select products from your catalog and print barcode label sheets directly from the browser — no external software required.
| Option | Description |
|---|---|
| Product selection | Choose individual products or filter by barcode status (has EAN, missing, etc.) to build a print queue. |
| Barcode type | Choose which barcode to print — EAN-13, UPC-A, or GTIN-14. Falls back to whichever type a product has if the preferred one is missing. |
| Show product name | Print the product name above the barcode on each label. |
| Show barcode digits | Print the raw barcode number below the barcode image. |
| Print All Labels | Sends all queued labels to the browser's print dialog. Works with any printer. |
10 Storefront display
When Show barcodes on storefront is enabled, barcode information appears in the product features section on the product detail page.
| What customers see | Details |
|---|---|
| Barcode image | Rendered by CS-Cart's image.barcode endpoint at the configured width and height. Shows whichever types are assigned to the product. |
| Barcode number | Displayed as plain text below the image when Show digits is enabled. Useful for customers who need to record or enter the code manually. |
| Theme support | Templates included for both Nova and Responsive built-in CS-Cart themes. Custom themes may need minor template adaptation. |
11 Multi-Vendor support
EAN/UPC/GTIN Pro is fully compatible with CS-Cart Multi-Vendor and CS-Cart Ultimate. The addon auto-installs on both editions.
| Who | What they can do |
|---|---|
| Root administrator | Full access to all products, dashboard (including vendor coverage table), bulk import, and all settings. |
| Vendor | Can view and edit barcodes on their own products only. Vendor panel shows their own coverage stats. Controlled by Allow vendors to manage barcodes setting. |
| Admin approval | Optional. When enabled, vendor barcode changes are held for review before being applied to the storefront. |
company_id in fn_get_products(). Vendors never see or touch another vendor's products regardless of settings.12 Languages
All admin panel strings, validation messages, storefront labels, and settings tooltips ship in two languages.
Additional translations can be added by creating a var/langs/{code}/addons/ean_upc_gtin.po file following CS-Cart's standard PO format.
Ready to add GS1 barcodes to your store?
Get EAN/UPC/GTIN Pro on the CS-Cart Marketplace or try the live demo first.
13 FAQ
Does CS-Cart support EAN-13 natively? ▼
What is GS1 mod-10 checksum validation? ▼
Will it break my current barcode setup? ▼
How do I assign barcodes to hundreds of products quickly? ▼
Can vendors in Multi-Vendor manage their own barcodes? ▼
What happens if I uninstall the addon? ▼
ean_code, upc_code, and gtin_code columns from ?:products, and drops the history and scan log tables. All barcode data is permanently deleted — export a CSV backup first if you want to preserve it.Does it work with custom CS-Cart themes? ▼
design/themes/responsive/templates/addons/ean_upc_gtin/ into your theme's equivalent folder and adjust the markup to match your theme's product page structure.14 Common use cases
How to add EAN codes to CS-Cart products
Navigate to Products → Edit Product → EAN / UPC / GTIN tab. Enter a 13-digit EAN-13 code in the EAN field — the add-on validates the GS1 mod-10 checksum in real time. If you have a 12-digit partial code, click Auto-generate to calculate and fill in the correct check digit automatically. Save the product — the barcode is stored and immediately available on the storefront.
How to fix invalid EAN barcode errors in CS-Cart
The most common cause is a wrong check digit. Every GS1 barcode ends with a check digit calculated from the preceding digits. If you receive an "Invalid GS1 checksum" error: enter the first 12 digits of the EAN-13 (or 11 digits of UPC-A) and use the Auto-generate button — the add-on calculates and fills in the correct check digit. If you receive "Only numeric digits allowed", remove any spaces, dashes or letters from the code.
How to import barcodes via CSV in CS-Cart
Go to Products → EAN/UPC/GTIN Pro → Bulk Import / Export. First export your current catalog to get the correct CSV format — columns are Product code, EAN, UPC, GTIN. Fill in barcode values in your spreadsheet, then import the file back. The add-on validates every checksum on import and skips invalid rows, showing an error report. Valid rows are applied immediately.
How to print barcode labels from CS-Cart
Navigate to Products → EAN/UPC/GTIN Pro → Print Labels. Select the products you want to print, choose the barcode type (EAN-13, UPC-A, or GTIN-14) and click Print All Labels. The browser's native print dialog opens — compatible with any printer. No external software, no PDF generator, no export needed.
How to show barcodes on the CS-Cart product page
Enable Show barcodes on storefront in the add-on settings (Add-ons → Manage Add-ons → EAN/UPC/GTIN Pro → Settings). The barcode image and digits will appear in the product features section on both Nova and Responsive themes automatically — no template edits required.