# Output descriptors: describing what a Bitcoin wallet can find A Bitcoin output descriptor is a text expression describing the scripts a wallet should recognize or generate, including relevant keys and derivation information. It can make wallet recovery and watch-only setup more explicit. A descriptor checksum catches certain transcription errors; it does not prove ownership, safety or secrecy. Evidence: [Output Script Descriptors General Operation](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0380.mediawiki); [importdescriptors RPC](https://bitcoincore.org/en/doc/29.0.0/rpc/wallet/importdescriptors/) Canonical: https://degreesofsatoshi.com/encyclopedia/bitcoin-output-descriptors/ Published: 2026-10-02 Substantively modified: 2026-10-02 Independently verified by an automated reviewer: 2026-10-02T18:15:23.891Z Data current through: 2026-10-02 AI-assisted research and drafting with a separate automated source-verification pass; no external expert or named human review is implied. ## Key facts - **Purpose:** A descriptor describes output scripts and associated key expressions. ([Output Script Descriptors General Operation](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0380.mediawiki)) - **Range:** Ranged descriptors can describe a sequence of derived outputs. ([Output Script Descriptors General Operation](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0380.mediawiki)) - **Sensitivity:** A descriptor may contain public or private key material; inspect its type before sharing. ([Output Script Descriptors General Operation](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0380.mediawiki)) ## Describe a wallet’s outputs rather than a single address An address identifies a particular payment destination. A descriptor can describe how an entire family of output scripts is constructed. That distinction matters when a wallet needs to recognize receiving and change outputs over time. Key-origin and derivation information helps cooperating wallets agree on which keys belong to a script. It is operational metadata, not proof that a particular person owns the funds. Evidence: [Output Script Descriptors General Operation](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0380.mediawiki) ## What an import needs to know Bitcoin Core’s import interface includes a descriptor, timestamp and options such as active status and ranges. A timestamp helps define the historical search required to find activity. Importing the text does not necessarily make every historical transaction appear instantly. A descriptor that contains only public information can support recognition without supplying spending authority. A descriptor containing secret material requires the same care as other sensitive key backups. Evidence: [importdescriptors RPC](https://bitcoincore.org/en/doc/29.0.0/rpc/wallet/importdescriptors/) ## What the checksum protects The descriptor checksum is designed to detect transcription mistakes in the descriptor text. It is useful when copying a long expression between systems. A correctly checksummed malicious descriptor remains malicious, and a valid public descriptor can still reveal transaction relationships. Check provenance and privacy separately from syntax. Evidence: [Output Script Descriptors General Operation](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0380.mediawiki) ## Questions ### Is a descriptor the same as a seed phrase? No. A descriptor describes scripts and key derivation. A mnemonic seed scheme is a way of deriving key material. Recovery may require both the appropriate keys and enough wallet-policy information to locate and spend outputs. Evidence: [Output Script Descriptors General Operation](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0380.mediawiki); [Mnemonic code for generating deterministic keys](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0039.mediawiki) ## Claims and scope ### bitcoin-output-descriptors-quick-answer A Bitcoin output descriptor is a text expression describing the scripts a wallet should recognize or generate, including relevant keys and derivation information. It can make wallet recovery and watch-only setup more explicit. A descriptor checksum catches certain transcription errors; it does not prove ownership, safety or secrecy. Scope: {"collection":"bitcoin","dataAsOf":"2026-10-02","blockHeight":null} ### bitcoin-output-descriptors-fact-purpose Purpose: A descriptor describes output scripts and associated key expressions. Scope: {"collection":"bitcoin","dataAsOf":"2026-10-02","blockHeight":null} ### bitcoin-output-descriptors-fact-range Range: Ranged descriptors can describe a sequence of derived outputs. Scope: {"collection":"bitcoin","dataAsOf":"2026-10-02","blockHeight":null} ### bitcoin-output-descriptors-fact-sensitivity Sensitivity: A descriptor may contain public or private key material; inspect its type before sharing. Scope: {"collection":"bitcoin","dataAsOf":"2026-10-02","blockHeight":null} ## Sources - [Output Script Descriptors General Operation](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0380.mediawiki) — Bitcoin BIPs contributors. Descriptors describe output scripts, keys and derivation information. Locator: Specification; Key expressions; Checksum. Retrieved: 2026-10-02T17:22:20.620Z. - [importdescriptors RPC](https://bitcoincore.org/en/doc/29.0.0/rpc/wallet/importdescriptors/) — Bitcoin Core. Descriptor import, active ranges, timestamps and watch-only use. Locator: Arguments and result fields. Retrieved: 2026-10-02T17:03:40.832Z. - [Mnemonic code for generating deterministic keys](https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0039.mediawiki) — Bitcoin BIPs contributors. The optional passphrase participates in deriving a different seed. Locator: From mnemonic to seed. Retrieved: 2026-10-02T17:22:20.588Z. ## Revision history - 2026-10-02: Initial Bitcoin encyclopedia entry at this permanent URL. - 2026-10-02: Added reusable claims, explicit source locators, and matching Markdown and JSON. This publishing change does not itself establish factual verification. ## Cite this entry Degrees of Satoshi editorial project. “Output descriptors: describing what a Bitcoin wallet can find.” Published 2026-10-02; updated 2026-10-02. https://degreesofsatoshi.com/encyclopedia/bitcoin-output-descriptors/