Skip to content

Deprecate state_topic and value_template for MQTT device_tracker#45665

Open
jbouwh wants to merge 5 commits into
nextfrom
mqtt-device_tracker-in_zones
Open

Deprecate state_topic and value_template for MQTT device_tracker#45665
jbouwh wants to merge 5 commits into
nextfrom
mqtt-device_tracker-in_zones

Conversation

@jbouwh
Copy link
Copy Markdown
Contributor

@jbouwh jbouwh commented May 31, 2026

Proposed change

Deprecate state_topic and value_template for MQTT device_tracker.

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 review requested due to automatic review settings May 31, 2026 14:24
@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 May 31, 2026
@netlify
Copy link
Copy Markdown

netlify Bot commented May 31, 2026

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit dc54044
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/6a2085a1e8c5f60008f7ac0a
😎 Deploy Preview https://deploy-preview-45665--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.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR updates the MQTT device tracker documentation for the deprecation of state_topic and value_template, with added guidance around using json_attributes_topic for location updates.

Changes:

  • Expands the json_attributes_topic description with coordinate and zone-based location payload details.
  • Removes state_topic, value_template, and related payload options from the configuration table.

Comment thread source/_integrations/device_tracker.mqtt.markdown
Comment thread source/_integrations/device_tracker.mqtt.markdown
Comment thread source/_integrations/device_tracker.mqtt.markdown
Comment thread source/_integrations/device_tracker.mqtt.markdown
Comment thread source/_integrations/device_tracker.mqtt.markdown
Comment thread source/_integrations/device_tracker.mqtt.markdown
Comment thread source/_integrations/device_tracker.mqtt.markdown
Comment thread source/_integrations/device_tracker.mqtt.markdown
@home-assistant
Copy link
Copy Markdown

home-assistant Bot commented Jun 1, 2026

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

@home-assistant home-assistant Bot marked this pull request as draft June 1, 2026 05:13
@jbouwh jbouwh marked this pull request as ready for review June 3, 2026 19:54
@home-assistant home-assistant Bot requested a review from c0ffeeca7 June 3, 2026 19:54
@home-assistant
Copy link
Copy Markdown

home-assistant Bot commented Jun 3, 2026

Hey there @emontnemery, @bdraco, mind taking a look at this feedback as it has been labeled with an integration (mqtt) you are listed as a code owner for? Thanks!

Code owner commands

Code owners of mqtt can trigger bot actions by commenting:

  • @home-assistant close Closes the feedback.
  • @home-assistant mark-draft Mark the pull request as draft.
  • @home-assistant ready-for-review Remove the draft status from the pull request.
  • @home-assistant rename Awesome new title Renames the feedback.
  • @home-assistant reopen Reopen the feedback.
  • @home-assistant unassign mqtt Removes the current integration label and assignees on the feedback, add the integration domain after the command.
  • @home-assistant update-branch Update the pull request branch with the base branch.
  • @home-assistant add-label needs-more-information Add a label (needs-more-information) to the feedback.
  • @home-assistant remove-label needs-more-information Remove a label (needs-more-information) on the feedback.

Copy link
Copy Markdown
Contributor

@c0ffeeca7 c0ffeeca7 left a comment

Choose a reason for hiding this comment

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

Thank you, @jbouwh 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

by-code-owner has-parent This PR has a parent PR in another repo integration: mqtt next This PR goes into the next branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants