Skip to main content Skip to docs navigation
View on GitHub

Q&A

Simple answers to common Auto Clicker – Auto Fill questions. Written for everyone.

On this page

Getting started

Q: How do I start the auto clicker?

Create a Configuration for your website, add Actions, then start it with the status bar hotkey or by visiting a matching URL. Learn more: Configuration Overview

Q: Where do I put the page element I want to click or fill?

Use the action’s Element Finder. Every action needs:

  • Finder: how to locate the element
  • Value: what to do (click, paste text, etc.)

Q: What is “Element Finder”?

It’s how you point to something on the page (a button, input, link). You can use:

  • Text-based paths (XPath)
  • CSS selector (querySelector)
  • Shortcuts like Id::, Name::, ClassName::, Selector:: More: Element Finder

Q: How do I add a new action?

Open your Configuration → Actions → Add. Set the Finder, choose the Value (what to do), and adjust timing or conditions if needed. Details: Action Settings

Selectors (how to point to elements)

Q: What are some Finder examples?

  • XPath: //button[contains(., 'Apply')]
  • CSS selector: Selector::input[type="email"]
  • By id: Id::username
  • By name: Name::login
  • By class: ClassName::form-control
  • Many elements: SelectorAll::li.item (use with "Query All" actions)

Q: I see “invalid XPath expression”. What does that mean?

Use regular ASCII characters (use @ not the full‑width ＠), match quotes correctly, and don’t paste raw HTML. Example that works:

//select[@id='ShippingCityRegionID']

Q: How do I match changing (dynamic) IDs?

Try stable attributes first (like name, role, data-*). If needed:

  • Starts with:
//*[starts-with(@id,'react-select-')]
  • Ends with (workaround):
//*[substring(@id, string-length(@id) - string-length('_r_3') + 1) = '_r_3']

Q: How do I pick the first or nth result when many match?

Add a position:

(//*[contains(text(),'Tom')])[1]
(//*[contains(text(),'Tom')])[5]

//a[contains(@href, '/d/') and contains(@href, '/apply')]

Q: Can I match one of two texts? 

//*[contains(text(),'Tom') or contains(text(),'Nick')]

Q: Should I use full (absolute) paths?

Avoid full paths. Use robust, readable selectors (text, labels, names, data-attributes).

Common actions and values

Q: How do I click a button?

  • Finder: point to the button
  • Value: MouseEvents::click More: Mouse Events

Q: How do I double‑click?

Use MouseEvents::dblclick.

Q: How do I fill a text field?

  • Finder: the input
  • Value: Paste::Your text (or Replace/Append/Prepend) More: Paste

Q: Only fill if the field is empty?

Add an Action Condition “Value equals '' (empty)” before your fill action. Action Condition

Q: How do I clear a field?

Use Replace:: with an empty value, or select-all + backspace via KeyboardEvents.

Q: How do I press Enter (or other keys)?

Use KeyboardEvents::Enter (or combinations). Keyboard Events

Q: How do I hold a key or long‑press the mouse?

Split into down and up with a pause:

  1. MouseEvents::mousedown → wait
  2. MouseEvents::mouseup

Q: How do I scroll to an element?

Use ScrollTo::. Scroll To

Q: How do I open a URL (same tab or new tab)?

  • Same tab: LocationCommand::replace=https://...
  • New tab: LocationCommand::open=https://... More: Location Command

Q: How do I focus a window or tab?

Use WindowCommand::focus. Window Command

Q: How do I select an option in a normal <select> dropdown?

Use Select Option by text or value. Select Option

Q: How about Select2/rc-select/custom dropdowns?

  • Click the dropdown to open it
  • Type into the search box
  • Click the result by its visible text

Tip for rc-select: target the input (role="combobox"), then pick the matching list item by its text.

Q: I get “css-dvua67-singleValue is not unique”.

Click the dropdown trigger first, then select the item in the open list by its exact visible text (not the summary chip).

Timing, repeats, and scheduling

Q: What is Init Wait (sec)?

A delay before an action or configuration starts. Set 0 for no delay. Timing

Q: Why is there a 5s delay before actions?

Lower the Retry Interval in Global Settings and set each action’s Init Wait to 0 if you don’t want a delay.

Q: Can I repeat actions N times or forever?

Yes. Use Batch Repeat. A value of -2 means repeat forever. Batch Repeat

Q: How do I add a short delay between actions?

Add a tiny Wait action (Finder //html) or set a small Init Wait on the next action.

Q: Can I run every X minutes/hours?

Use Batch Repeat with Init Wait/Retry Interval. To refresh the page between runs, add a final LocationCommand::reload and let the URL match restart it.

Conditions and branching

Q: Run an action only if some text exists?

Add an Action Condition with a Finder for that element; use “contains text” (or “exists”). Action Condition

Q: If‑then flows (skip/refresh/go‑to)?

Use the action’s On‑Failure behavior (Skip action / Refresh / Go to action) plus conditions to create simple branches.

Q: Click “Tom” if it exists, else “Nick”?

  • Action 1: condition-check for “Tom”
  • Action 2: if not found, target “Nick”

Q: Keep running even if the element isn’t found?

Set On‑Failure to “Skip action” (or “Refresh”) and use Retry -2 to keep looping.

URLs and patterns

Q: Can I match multiple URLs or IPs?

Yes, use a regular expression in the Configuration URL. Examples:

  • ^https://108\.181\..*
  • ^https://(108\.181|208\.87)\..*
  • ^https://example\.com/(a|b|c)/.*

Learn more: Configuration URL

Q: Open another URL when done?

Final action:

  • Finder: //html
  • Value: LocationCommand::replace=https://...

iFrames and special pages

Q: How do I click inside an iframe (even nested ones)?

Turn on “Iframe First” for the action from action settings that targets the iframe’s content.

Q: Payment fields (like Stripe) won’t fill.

Many payment inputs live in secure, cross‑origin iframes and block automation. Use the site’s normal flow; scripted input often won’t work there.

Q: Sites built with React/Vue aren’t recording clicks well.

Use stable attributes (like data-*), clear text, or CSS selectors. Avoid absolute XPaths that change easily.

Google Sheets integration

Q: How do I pull a value from Google Sheets?

Use GoogleSheets::Sheet1!A1 as the Value. First, connect in Global Settings → Google Sheets. Google Sheets

Q: How do I go row by row each time it runs?

Use the session counter: GoogleSheets::Sheet1!A<sessionCount>. Session

Q: It types the literal text “GoogleSheets::Sheet1!A1”.

Reconnect and authorize Google Sheets in Global Settings, then reload and rerun.

Notifications and hotkeys

Q: Can I get a Discord message when it finishes?

Yes. Global Settings → Notifications → Connect Discord → enable “on configuration completion”. Show Notification

Q: “Invalid URL” after Discord authorize.

Update the extension, allow DMs, make sure the redirect isn’t blocked. Reconnect.

Q: Can I set a start/stop hotkey?

Yes. Configuration Settings → Hotkey (e.g., Ctrl+Shift+A). Config Settings – Hotkey

Error handling and logs

Q: How are errors handled?

Each action has On‑Failure behavior (Skip, Refresh, Go to). Check logs for details. Logs

Q: “Failed to execute 'evaluate' on 'Document' …”

Usually a malformed XPath (wrong quotes, leading colons, non‑ASCII characters). Fix the Finder and try again.

Q: “Undefined element”

The Finder didn’t match. Check the right iframe, dynamic loading, and timing.

Mini examples (copy‑paste friendly)

Q: Click by text

Finder: //button[contains(., 'Apply')] Value: MouseEvents::click

Q: First of many identical icons

Finder: (//i[@class='icon'])[1] Value: MouseEvents::click

Q: Label → checkbox

Finder: //label[normalize-space(.)='I agree']/input[@type='checkbox'] Value: MouseEvents::click

Q: Select option by text

Finder: //select[@name='city'] Value: SelectOption::text=Kitchener

Q: Custom dropdown (type + pick)

  1. Finder: //div[@role='combobox'] → Value: MouseEvents::click
  2. Finder: Selector::input[role='combobox'] → Value: Paste::tung
  3. Finder: //li[normalize-space(.)='tung'] → Value: MouseEvents::click

Q: Open a new tab at the end

Finder: //html Value: LocationCommand::open=https://example.com/next

Q: Wait 0.25s between actions

Add an action with Finder: //html and set Init Wait (sec): 0.25.

Q: Only fill empty input

  • Action 1 (condition): Finder → the input, Operator → value equals ''
  • Action 2 (fill): Finder → same input, Value → Paste::Your text

Special topics

Q: Can it solve CAPTCHAs, bypass protections, auto‑approve wallet transactions, or target gameplay?

Sorry, I can't assist with that.

Q: Will it work on payment screens or security keypads?

Many providers block automation there. Manual interaction is often required.

Q: Can I close a tab?

Use WindowCommand::close if available; otherwise not supported.

Q: Can I run one flow across multiple pages?

Yes. Use a URL pattern that matches all pages, and add actions that run conditionally per page.

Q: Can it react to SPA route changes without reloading?

Yes.

Quick troubleshooting

  • Check the URL pattern matches the current page (use regex if needed).
  • Lower Init Wait and Retry Interval if it feels slow.
  • Confirm the Finder points to the right element and iframe (enable Iframe First if needed).
  • Prefer clear, text‑based or attribute‑based selectors; avoid brittle full paths.
  • Review logs for details: Logs
  • Reconnect Google Sheets or Discord if values/notifications don’t work.
  • Update the extension to the latest version.