Allegro Shopify Integrations docs

Table of contents

1. Installation and launch
2. Allegro connection authorization
3. App settings
4. Creating an Allegro listing from a Shopify product
5. Detailed description of listing form fields
6. Listings and next actions

Installation and launch

The app runs inside Shopify Admin and provides three main areas:

• Home (onboarding),
• Listings,
• Settings.

To get started:

1. Install the app in your Shopify store.
2. Open the app from the Apps list in Shopify Admin.
3. Go to Settings to connect your Allegro account.

Allegro connection authorization

You connect Allegro in Settings → General Settings.

How to authorize

1. In the Allegro Connection section, click Connect Allegro Account.
2. An Allegro popup window opens (oauth flow).
3. Sign in to Allegro and grant app access.
4. After successful authorization, the popup closes automatically and the status changes to Connected.

What the user sees

• connection status: Connected / Not Connected,
• button Connect Allegro Account or Disconnect,
• success or error message after authorization.

Disconnecting the account

1. In the same section, click Disconnect.
2. The app removes OAuth tokens and disconnects the Allegro channel in the app.

App settings

This area configures the Allegro connection and the data used to build listings. Proper setup reduces listing time and validation errors.

The Settings view has 3 tabs.

1. General Settings

This tab is used to manage OAuth connection and core app behavior. You set the store location and Allegro API language here.

• Allegro Connection (connect/disconnect),
• Store Location (active Shopify location used for Allegro listings),
• Allegro API Language (Polish (Polski) or English),
• button Save Settings (visible when changes exist).

2. Categories

In this section you build the list of Allegro categories used later in listing forms. Categories can be added manually or discovered automatically by EAN scan.

• add Allegro categories manually by ID,
• browse category tree and pick leaf categories,
• save category list with Save Categories,
• Scan Products.

1. scans Shopify products by EAN,
2. shows discovered categories,
3. lets you select and add discovered categories to settings.

3. Description Templates

This tab lets you prepare reusable listing descriptions so you do not build content from scratch for every product. Templates support dynamic Shopify variables.

• create reusable description templates,
• content blocks: text, image, text + image, features list,
• use Shopify variables (for example title, description, price, SKU, EAN),
• save changes with Save Changes.

Creating an Allegro listing from a Shopify product

Go to Listings and click Create Listing.

The form is split into sections:

1. Product Source
2. Category & Specifications
3. Auction Parameters
4. Description & Images
5. Delivery & Payment
6. Policies
7. GPSR

Typical flow:

1. Select a Shopify product and variant.
2. Verify or complete EAN.
3. If catalog matches are found, click Fetch from catalog.
4. Select category and specification parameters.
5. Fill title, price, stock, and listing duration.
6. Verify description and image gallery.
7. Configure delivery, payment, and policies.
8. Save a draft, optionally run Validate with Allegro, then Publish to Allegro.

Detailed description of listing form fields

Section: Product Source

This section selects the Shopify product/variant used as the listing base. It can also pull Allegro catalog data from EAN.

Section: Category & Specifications

This section defines Allegro category and required category-specific attributes. Correct values are critical for successful publication and offer visibility.

Notes:

1. Required dictionary parameters may be auto-filled with the first available value when empty.
2. Changing category resets previously selected parameters.

Section: Auction Parameters

This section sets core selling conditions: title, price, stock, and duration. It is one of the key sections for form validation and publishing.

Section: Description & Images

This section controls product presentation on Allegro: image gallery and description content. You can apply a template or build description blocks manually.

Section: Delivery & Payment

This section configures shipping and invoice settings for the offer. Values are based on your Allegro account setup.

Section: Policies

This section contains Allegro post-sale policies required for listing. You can also attach warranty terms and additional services.

Section: GPSR

This section covers product safety information required by GPSR for selected categories/products. You can assign or create responsible entities directly here.

Form: new producer (GPSR)

Fields:

• Producer Name (internal),
• Trade Name,
• Country,
• Postal Code,
• City,
• Street,
• Phone,
• Email.

Form: new responsible person (GPSR)

Fields:

• Internal Name,
• Person/Company Name,
• Country,
• Postal Code,
• City,
• Street,
• Phone,
• Email.

Listings and next actions

In Listings you get:

• listings table (product, status, price, stock, created date, actions),
• search by product name or offer ID,
• statuses: Draft, Activating, Active, Inactive, Ended.

Available actions per listing:

• Edit,
• End Auction,
• Renew Auction,
• Copy,
• View on Allegro,
• Remove from list.

Actions in listing editor sidebar:

• Save Draft / Update Draft / Update Auction,
• Validate with Allegro,
• Publish to Allegro,
• optional: Copy as new.