# Group Extraction

## What is Group Extraction?

Group extraction is a **feature that lets you collect multiple pages at once**.

{% columns %}
{% column width="83.33333333333334%" %}

<figure><img src="https://content.gitbook.com/content/goHfMCeMlqJPW61OR5d1/blobs/TpI47wtFVQqTWmUCJTaR/%E1%84%80%E1%85%B3%E1%84%85%E1%85%AE%E1%86%B8%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF%201.gif" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="16.666666666666657%" %}

{% endcolumn %}
{% endcolumns %}

After extracting one representative page first, click the **\[+Group]** button in the result window and add URLs of related pages—Listly will automatically extract the rest.

***

## Preparing URLs before Group Extraction

Group extraction requires entering multiple page URLs at once, so it's good to prepare URLs of pages to extract in advance.

Depending on your situation, refer to these guides to prepare the necessary URLs first:

* [Group Extraction - Generate 1,2,3…Sequential Page URLs](https://help.listly.io/getting-started/result-page-features/group-extraction-sequential-urls)
* [Group Extraction - Extract Detail Page URLs](https://help.listly.io/getting-started/result-page-features/group-extraction-detail-page-urls)

***

## Important Notes

{% columns %}
{% column width="83.33333333333334%" %}

<figure><img src="https://content.gitbook.com/content/goHfMCeMlqJPW61OR5d1/blobs/DwmEaDrncdvvZDiUx0jl/%E1%84%80%E1%85%B3%E1%84%85%E1%85%AE%E1%86%B8%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF%202.gif" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="16.666666666666657%" %}

{% endcolumn %}
{% endcolumns %}

**The first page extracted in group extraction serves as a 'template'.**\
Group extraction works by fetching data from the same locations on other pages as the positions selected on this first page.

Therefore, **extraction may fail if the page structure differs between the first extracted page and subsequently entered URLs.**\
Before proceeding with group extraction, make sure page structures are identical.

***

## How to Use&#x20;

{% stepper %}
{% step %}

#### Extract the group extraction source page

First extract the source page that will serve as the group extraction reference. It doesn't have to be the first URL in your list—just select **a page with representative structure among pages you'll group extract**. Both Whole / Parts extraction methods work, but [**Parts Extraction**](https://help.listly.io/getting-started/extension-features/parts) is recommended as **it lets you specify data locations more precisely**.

<figure><img src="https://content.gitbook.com/content/goHfMCeMlqJPW61OR5d1/blobs/MdeDt5agzw4lMFR7spSR/%E1%84%80%E1%85%B3%E1%84%85%E1%85%AE%E1%86%B8%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF%203.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Select the extraction tab

**Select a tab containing the information you want** in the result window. Choose a tab that includes all information in the selected area.

<figure><img src="https://content.gitbook.com/content/goHfMCeMlqJPW61OR5d1/blobs/3h8EIcvtluVmuFydaIt2/%E1%84%80%E1%85%B3%E1%84%85%E1%85%AE%E1%86%B8%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF%204.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Click the \[+Group] button

Click the **\[+Group]** button.

<figure><img src="https://content.gitbook.com/content/goHfMCeMlqJPW61OR5d1/blobs/N8VnBeihovQtPhifgEws/%E1%84%80%E1%85%B3%E1%84%85%E1%85%AE%E1%86%B8%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF%205.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Paste URLs needed for group extraction

Paste the **prepared URLs** at the bottom of the group settings window and click the **\[Done]** button.

<figure><img src="https://content.gitbook.com/content/goHfMCeMlqJPW61OR5d1/blobs/8iBEA07XWJIAAehF51rR/%E1%84%80%E1%85%B3%E1%84%85%E1%85%AE%E1%86%B8%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF%206.png" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
You must **also include the URL of the source page where you did the initial extraction**.
{% endhint %}
{% endstep %}

{% step %}

#### Check group extraction progress

During group extraction, refresh Databoard to check progress. When extraction completes, click the result field to go to the group result window.

<figure><img src="https://content.gitbook.com/content/goHfMCeMlqJPW61OR5d1/blobs/NZkorWaqZqbBqioRwCQg/%E1%84%80%E1%85%B3%E1%84%85%E1%85%AE%E1%86%B8%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF%207.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Select data arrangement method

Click Excel or Google Sheets button, select data arrangement method, then click download button.

{% hint style="info" %}
Reference: [1 card per row / 1 tab per row](https://help.listly.io/getting-started/result-page-features/data-arrangement)
{% endhint %}

<figure><img src="https://content.gitbook.com/content/goHfMCeMlqJPW61OR5d1/blobs/Fm7TDo3fRGBmN7gplGD8/%E1%84%80%E1%85%B3%E1%84%85%E1%85%AE%E1%86%B8%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF%208.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/goHfMCeMlqJPW61OR5d1/blobs/aLJbEIAjh0cezmyr8ltu/%E1%84%80%E1%85%B3%E1%84%85%E1%85%AE%E1%86%B8%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF%209.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Group extraction complete

Open the downloaded file to check your extracted data. Group extraction is complete!

<figure><img src="https://content.gitbook.com/content/goHfMCeMlqJPW61OR5d1/blobs/8o9JUXuCGsTjPHCWj0hR/%E1%84%80%E1%85%B3%E1%84%85%E1%85%AE%E1%86%B8%E1%84%8E%E1%85%AE%E1%84%8E%E1%85%AE%E1%86%AF%2010.png" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}