> ## Documentation Index
> Fetch the complete documentation index at: https://docs.luxima.io/llms.txt
> Use this file to discover all available pages before exploring further.

# GS1

> Bring your registered GTINs and product details in from GS1.

GS1 is the organisation that issues GTINs, the numbers behind your barcodes. If you license your barcodes from GS1, your products are already registered there with their GTIN and a description.

## Why connect GS1

* **GTINs are right the first time.** They come from the registry that issued them, so there are no typing mistakes or wrong check digits.
* **Better passport links.** A variant with a valid GTIN gets a GS1 Digital Link, the standard link format for product passports. See [Links and QR codes](https://docs.luxima.io/passports/links-and-qr-codes.md).
* **A fast start.** Your whole registered range becomes a product list in LUXIMA, grouped into styles with their sizes and colours.
* **A reliable key for other sources.** LUXIMA matches products across sources by GTIN. With GTINs from GS1 in place, data from your spreadsheet, ERP or website lands on the right product.

## What you need

* The **Growth** or **Enterprise** plan.
* A **GS1 Ireland Barcode Manager** login: your username and your API password.
* The Owner or Admin role in LUXIMA.

## Connect

**1. Open GS1**

Go to **Integrations**. On the **GS1** card, click **Connect**.

**2. Enter your details**

Fill in **GS1 username** and **GS1 API password**. Leave **API URL** as it is unless GS1 gave you a different one.

**3. Connect**

Click **Connect GS1**. LUXIMA logs in to check the details. When it works, the panel shows "Connected as" with your username and your GS1 organisation.

Your credentials are stored encrypted. LUXIMA only reads from GS1.

## Import your GS1 products

Click **Import** on the GS1 row, then **Import with a workflow**. GS1 is added as a source in an [import workflow](https://docs.luxima.io/import-export/import-overview.md), where you pick the products, add other sources if you like, review, and save.

## What GS1 brings in

* GTIN
* Product name (the GS1 description)
* Product code
* Category
* Size and colour, read from the description

GS1 does not hold fibre composition, weights or photos. Add a second source for those, such as a spreadsheet or your website.

> [!TIP]
>
> A good order for a workflow is GS1 first, then your spreadsheet or ERP, then your website for photos.

## The numbers on the GS1 row

After LUXIMA has read your GS1 range, the row shows three counts:

| Count | Meaning |
| - | - |
| **New** | In GS1 but not in LUXIMA yet. |
| **Changed** | In both, with different details. |
| **Matched** | In both, and the same. |

LUXIMA reads GS1 when you run an import. To pick up GTINs you registered later, run the import again.

## Change or remove the connection

Open **Settings** on the GS1 row.

* **Edit** lets you enter a new password or API URL. Click **Save credentials**.
* **Forget credentials** removes the connection. Products you already imported stay in your catalogue.

## Messages you might see

| Message | What to do |
| - | - |
| "GS1 rejected the supplied username or password" | Check both. The password is your GS1 API password. |
| "Could not reach GS1 login service" | GS1 may be unavailable. Try again later. |
| "GS1 token is not authorised for this resource" | Your GS1 account lacks access to the product data. Contact GS1. |
| "No GTIN in GS1" (on a product) | That item has no GTIN in your GS1 account. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.