How can I trigger a GitHub Action only when a file in a specific folder changes?

[Ghartic-Dere]

Why are you starting this discussion?

Question

What GitHub Actions topic or product is this about?

Actions Runner

Discussion Details

Hi all,
I’m setting up a GitHub Action and I’d like it to run only when files in a specific folder (e.g. /src/) are modified.

I’ve tried using paths in the workflow trigger like this:

on:
  push:
    paths:
      - 'src/**'

But it still seems to run even when changes are made outside the src/ folder.
• Am I missing something?
• Is there a reliable way to scope the trigger strictly to that folder?
• Also, does this work with pull_request events the same way?

Thanks in advance!

[turtle-key]

Hi @Ghartic-Dere,

Your workflow config using paths is almost correct and should generally work as expected. Here are a few notes and tips to help you troubleshoot and clarify:

1. Correct Usage Example
   Your YAML should look like this:

on:
  push:
    paths:
      - 'src/**'
  pull_request:
    paths:
      - 'src/**'

This setup will trigger the workflow only when files inside the src/ directory are changed, for both push and pull_request events.

2. Why might it still run on other changes?

• Ensure there aren’t other triggers in your workflow (like on: push: without paths) that could fire on any change.
• Double-check for indentation or YAML formatting errors.
• If you have multiple workflows, make sure you’re editing the correct one.

3. How does it work with pull requests?
   Yes, paths works with pull_request events the same way. Just be sure to add the paths filter under the pull_request: key as above.

4. Known Limitations

• Certain actions like labeling, closing, or reopening PRs won’t trigger on file changes, only the types of events defined in your workflow.
• Wildcards like 'src/**' match all files and folders recursively under src/.

Reference:

• Workflow syntax: using paths

If it’s still running unexpectedly, feel free to share your full workflow YAML and more context so we can help you debug further!

Hope this helps!

[Ghartic-Dere]

Oh, @turtle-key, thanks for the suggestions!