---
description: A key-value pair attached to a page or object, used for querying and filtering.
tags: glossary
references:
- client/codemirror/attribute.ts
- plugs/index/attribute.ts
---
Attribute syntax can contribute additional [[Metadata]] to various [[Object|Objects]], including:

* Pages (although the preferred way is [[Frontmatter]])
* Items (bulleted and numbered list items)
* [[Task|Tasks]]
* Paragraphs

## Syntax
The syntax is as follows:

```
[attributeName: value]
```

For Obsidian/LogSeq compatibility, you can also double the colon like this: `[attributeName:: value]`
 
Attribute names need to be alpha-numeric. Values are interpreted as [[YAML]] values. So here are some examples of valid attribute definitions:

* string: [attribute1: sup]
* number: [attribute2: 10]
* array: [attribute3: [sup, yo]]

Multiple attributes can be attached to a single entity, e.g. like so:

* Some item [attribute1: sup][attribute2: 22]

## Scope
Depending on where these attributes appear, they attach to different things. For instance, this attaches an attribute to a page:

[pageAttribute: hello]

However, usually, [[Frontmatter]] is used for this purpose instead.

Example query:

${query[[
  from index.pages()
  where _.name == editor.getCurrentPage()
  select {name=_.name, pageAttribute=_.pageAttribute}
]]}

This attaches an attribute to an item:

* Item [itemAttribute: hello] #specialitem

Example query:

${query[[
  from index.items("specialitem")
  where itemAttribute == "hello"
  select {
    name = _.name,
    itemAttribute = _.itemAttribute
  }
]]}

This attaches an attribute to a task:

* [ ] Task with an attribute, I’m so cool [taskAttribute: hello]

Example query:

${query[[
  from index.tasks()
  where taskAttribute == "hello"
  select {
    name = _.name,
    taskAttribute = _.taskAttribute
  }
]]}