# ActionScript

## What is Action Script?

Action Script is an advanced feature that goes beyond just extracting what's visible on screen—**it lets you write JavaScript code directly to control the extraction process**.

<figure><img src="/files/26d172b3be6509a1e7343d59b3b4e3ef9841cf29" alt=""><figcaption></figcaption></figure>

Examples:

* Extract data from sections that appear after clicking specific buttons
* Extract data from areas that appear on mouseover
* Control other dynamically changing elements within sites before collecting data

You can **customize data extraction for special situations** that are difficult to solve with regular Listly automation settings.

{% hint style="warning" %}
Action Script creation service is an **Enterprise plan exclusive option**. If you're on a lower-tier plan, you can write scripts yourself to use this feature.
{% endhint %}

{% stepper %}
{% step %}

### Whole Extract then open Browser Setting

Perform a Whole Extract of the web page, then click the \[Browser Setting] section on the result page to go to that task's settings screen.

<figure><img src="/files/ed310303e2b9b7bbc11cdba3828bae843f38a59e" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Paste your JS into Action Script and Save

Paste your written JS code into the Action Script field on the settings screen and click **\[Save]**

{% hint style="success" %}
**TIP** These days you can even use AI services like Chat GPT to write simple scripts. The Listly team shared their experience using ChatGPT to generate Action Scripts in a newsletter—check it out:\
👉[ Asked ChatGPT to write Action Script for me and "This actually works?"](https://maily.so/listly.io/posts/knrje7v0zld)
{% endhint %}

<figure><img src="/files/8d8654d1791911d24fb64ec9f4d846c90a7a1289" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Re-extract using Action Script

Click the **\[Re-extract]** button in the result window or Databoard to re-extract the data area using Action Script.

<figure><img src="/files/461d05611e22a1ea12e2d59533c0ddb3cfbbebac" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Verify results

Check the results after re-extraction completes. Make sure to verify that your configured Action Script worked as intended.

<figure><img src="/files/3d4ebc8a0d078d478ccd6809a721061642c0627b" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Important Notes

{% hint style="warning" %}
**Important notes when applying Action Script to Group Extraction tasks**

Action Script must be applied to the source page before group extraction. Group extraction assumes other URLs have the same structure as the representative page (source page) and collects data accordingly. If you don't apply Action Script to the source page, there's no reference for performing the same action on subsequently added URLs, which can cause **tab matching errors** or **data loss**.

* Always write and apply Action Script with the **representative page** open.
* After applying Action Script, you must first **re-extract** to verify the settings work properly.
* Then use the **\[+Group]** button to add URLs, and the same Action Script behavior will be reflected across all group pages.
* If there are significant structural differences between the source page and other pages, the script may not work properly, so it's important to only include **pages with the same structure** in group extraction.
  {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.listly.io/getting-started/result-page-features/actionscript.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.