Secret reference syntax - whitespace

On the CLI https://developer.1password.com/docs/cli/secrets-reference-syntax/#syntax-rules for secret references page, it allows use of 'the whitespace character' (I assume just the ASCII space character).

I can confirm the VS Code 1Password extension works with a secret reference of op://Private/Example - 123/Section 1/Password A.

The docs for the 1Password CLI https://developer.1password.com/docs/cli/reference/commands/run/#use-same-env-file-for-multiple-sets-of-secrets / op run commands says reference names cannot contain whitespace.

You can specify each part of a secret reference using its name or ID. Reference names cannot contain any whitespaces or special characters, with the exception of hyphens (-) and underscores (_).

But it looks like whitespace is also supported there (for environment variables at least)?


$ export TEST_PASSWORD="op://Private/Example - 123/Section 1/Password A"
$ op run --no-masking -- printenv TEST_PASSWORD
my-password


If the official stance is still to not use whitespace (I can understand why), then it might be worth adding an admonition to the secrets reference syntax rules page as well, to point out the caveat of using whitespace in secret references?

1Password Version: op --version: 2.4.1
Extension Version: Not Provided
OS Version: Not Provided
Browser:_ Not Provided