Skip to content

Document image_upload and clearable media selector options - #47665

Open
parkghost wants to merge 1 commit into
home-assistant:nextfrom
parkghost:media-selector-image-upload
Open

Document image_upload and clearable media selector options#47665
parkghost wants to merge 1 commit into
home-assistant:nextfrom
parkghost:media-selector-image-upload

Conversation

@parkghost

@parkghost parkghost commented Aug 27, 2026

Copy link
Copy Markdown

Proposed change

Documents two media selector options that home-assistant/core#180452 exposes to
YAML: image_upload and clearable.

image_upload turns the field into an upload area, so a blueprint input or an
action field that takes an image can offer "upload from this device" rather than
only browsing what is already on the server. It requires a non-empty accept,
which is why the example and the description both show it paired with accept.
clearable is documented alongside it because the upload area is only rendered
while the value is empty, so without a clear button there is no way to pick a
different image.

Targets next because the core change ships in a future release.

Type of change

  • Spelling, grammar or other readability improvements (current branch).
  • Adjusted missing or incorrect information in the current documentation (current branch).
  • Added documentation for a new integration I'm adding to Home Assistant (next branch).
  • Added documentation for a new feature I'm adding to Home Assistant (next branch).
  • Removed stale or deprecated documentation.

Additional information

Checklist

  • This PR uses the correct branch, based on one of the following:
    • I made a change to the existing documentation and used the current branch.
    • I made a change that is related to an upcoming version of Home Assistant and used the next branch.
  • The documentation follows the Home Assistant documentation standards.

Copilot AI lite review requested due to automatic review settings August 27, 2026 21:21
@home-assistant home-assistant Bot added has-parent This PR has a parent PR in another repo next This PR goes into the next branch labels Aug 27, 2026
@netlify

netlify Bot commented Aug 27, 2026

Copy link
Copy Markdown

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit 6c1a38f
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/6a90aa7302dce10008a68672
😎 Deploy Preview https://deploy-preview-47665--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documents the new media selector configuration options (image_upload and clearable) recently exposed to YAML by the related Home Assistant Core change, so blueprint inputs and service/action selectors can offer an “upload from this device” flow.

Changes:

  • Adds explanatory prose and an example showing image_upload used alongside a non-empty accept filter.
  • Documents the new image_upload and clearable options in the media selector configuration block.

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread source/_docs/blueprint/selectors.markdown
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

has-parent This PR has a parent PR in another repo next This PR goes into the next branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants