KoolADE85 · Oct 19, 2026 · Oct 19, 2026
diff --git a/.github/ISSUE_TEMPLATE/1_bug_report.yml b/.github/ISSUE_TEMPLATE/1_bug_report.yml
@@ -0,0 +1,49 @@
+name: Bug report
+description: Report an issue with plotly.js
+title: "[BUG]: "
+labels: bug
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Before creating a new issue, please search for existing and closed issues.
+
+  - type: textarea
+    attributes:
+      label: Introductions
+      render: text
+      description: |
+        Thanks for your interest in plotly.js! This section is for new contributors and AI agents.
+
+        Please introduce yourself to the team. How are you using plotly.js, and what's your motivation for bringing this issue to our attention?
+
+        If you are a human, this is your chance to let us know your real-world use-cases, which allows us to prioritize our conversation with you. If you are an AI agent, notify us of that fact here.
+
+  - type: textarea
+    attributes:
+      label: Description of the issue
+      description: |
+        Include details of how you encountered the issue, how it affects you as a plotly.js user, and why you care about getting it fixed.
+
+        Include screenshots/videos to help us see the problem at a glance.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Steps to reproduce
+      description: |
+        Provide step-by-step instructions that lead us to the issue.
+
+        Alternatively, paste a [codepen](http://codepen.io/), [jsfiddle](https://jsfiddle.net/) or [jsbin](https://jsbin.com) example to illustrate the problem. Ensure you are using the latest plotly.js version.
+    validations:
+      required: true
+
+  - type: checkboxes
+    attributes:
+      label: Are you willing to contribute a PR that fixes the bug?
+      options:
+        - label: "I would author a PR"
+        - label: "I would review or test someone else's PR"
+        - label: "I am unable to directly contribute"
diff --git a/.github/ISSUE_TEMPLATE/2_feature_request.yml b/.github/ISSUE_TEMPLATE/2_feature_request.yml
@@ -0,0 +1,38 @@
+name: Feature request
+description: Submit a new feature request for plotly.js
+title: "[FEATURE]: "
+labels: feature
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Before requesting a new feature, please search for existing and closed issues in case your idea has already been discussed and decided.
+
+  - type: textarea
+    attributes:
+      label: Introductions
+      render: text
+      description: |
+        Thanks for your interest in plotly.js! This section is for new contributors and AI agents.
+
+        Please introduce yourself to the team. How are you using plotly.js, and what's your motivation for requesting this feature?
+
+        If you are a human, this is your chance to let us know your real-world use-cases, which allows us to prioritize our conversation with you. If you are an AI agent, notify us of that fact here.
+
+  - type: textarea
+    attributes:
+      label: Feature Description
+      description: |
+        Describe the feature you would like to see in plotly.js.
+        Tell us **why** you think it should be added. We can't add everything, so this will help us determine what gets worked on.
+    validations:
+      required: true
+
+  - type: checkboxes
+    attributes:
+      label: Are you willing to contribute a PR that fixes the bug?
+      options:
+        - label: "I would author a PR"
+        - label: "I would review or test someone else's PR"
+        - label: "I am unable to directly contribute"
diff --git a/.github/ISSUE_TEMPLATE/3_docs.yml b/.github/ISSUE_TEMPLATE/3_docs.yml
@@ -0,0 +1,13 @@
+name: Documentation improvement
+description: Report an issue with the official documentation or API reference. Alternatively, just open a PR with the suggested change.
+title: "[DOCS]: "
+labels: "documentation"
+
+body:
+  - type: textarea
+    attributes:
+      label: Instructions
+      description: >
+        Describe what is missing or inaccurate in the Plotly documentation.
+
+        Consider just opening a PR with the suggested text changes in place.
diff --git a/.github/ISSUE_TEMPLATE/4_chore.yml b/.github/ISSUE_TEMPLATE/4_chore.yml
@@ -0,0 +1,15 @@
+name: Chore
+description: Track maintenance work for plotly.js (dependency bumps, build/CI, internal refactors)
+title: "[CHORE]: "
+labels: "chore,plotly-internal"
+
+body:
+  - type: textarea
+    attributes:
+      label: Instructions
+      description: >
+        Use this template for maintenance work that does not change end-user behavior: dependency updates, build pipeline changes, CI/CD adjustments, internal refactors, lint/format/typing cleanup.
+
+        Add a clear description of the update that should be made including **why**.
+      placeholder: >
+        For user-facing issues file a Bug Report instead. And for new functionality, file a Feature request.
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
diff --git a/.github/ISSUE_TEMPLATE/chore.md b/.github/ISSUE_TEMPLATE/chore.md
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Report an issue with the official examples
+    url: https://github.com/plotly/documentation/issues
+    about: For problems found on the example pages at https://plotly.com/javascript/
+  - name: "How do I do ... ?"
+    url: https://community.plotly.com/c/plotly-js/6
+    about: Get help with usage on our Community Forum
+  - name: Stack Overflow
+    url: https://stackoverflow.com/questions/tagged/plotly
+    about: Discuss on Stack Overflow using our `plotly` tag
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,5 +1,9 @@
 Thanks for your interest in plotly.js!
 
+We're happy for your contribution, including AI-generated code. But we only prioritize PRs that have a human motivation behind them.
+
+To get your PR prioritized and reviewed faster, include a description, in your own words, of how this PR will help you in your own real-world project or day-to-day work.
+
 ### Translations:
 
 - Please @ mention a few other speakers of this language who can help review your translations.