Smart Collections Query Language is a powerful tool that allows you to build customized collections in your Bookmark library. With the ability to create advanced filter rules based on specific properties of your bookmarks, you can automate the organization of your library to suit your individual needs. The best part? Smart Collections work in the background, updating your collections automatically as you add new bookmarks. This guide will walk you through the basics of how to use this feature.

Understanding Properties and Operators

The Smart Collections Query Language uses properties and operators to create filter rules for your collections.

Properties

Properties represent the different attributes of your bookmarks. You can use these properties to create filter rules for your collections.

Here are the properties you can use:

• byline: This refers to the byline of the bookmark.
• content: This searches the text content, the title, and the summary of the bookmark.
• domain: This refers to the domain of the bookmark.
• tag: This searches the tags associated with the bookmark.
• title: This refers to the title of the bookmark.
• summary: This refers to the summary of the bookmark.

Operators

Operators are used to specify the kind of relationship between the property and the value you're searching for.

These are the operators you can use:

• is: This checks if a property is equal to a specific value. Example: domain is 'nytimes.com'.
• is not: This checks if a property is not equal to a specific value.
• contains: This checks if a property contains a specific value.
• does not contain: This checks if a property does not contain a specific value.
• is in: This checks if a property matches any value in a list of values. Example: tag is in 'sports, world news'.
• is not in: This checks if a property doesn't match any value in a list of values.

Examples of Using Smart Collections Query Language

Here are some examples of how you can use this query language:

• Search a single field for 'contains':

text contains "foo bar"

• Search a single field for 'equality':

title is "foo bar"

• Search content (text, summary, and title fields at once):

content contains "foo bar"

• Combine with logical and/or/not:

domain is "example.com" or domain is "example.net"
content does not contain "foo does not contain bar" and title is not "Foo is not Bar"

• Combine complex queries with parentheses and logical and/or:

domain contains "example.com" or not (title is "Foo Bar" or (tag is in "Baz, Qux" and tag is not in "Quux, Corge"))

Auto-Updating Collections

The best thing about Smart Collections is they work automatically in the background. When you create or modify a smart query, your collection updates instantly to reflect these changes. But that's not all! Any new bookmarks you add in the future that match your smart queries will also be automatically added to your collections. This means you set up your smart queries once, and your collections will keep themselves organized over time.

Remember, the key to using Smart Collections Query Language effectively is understanding the structure of your bookmarks and your specific needs. With a bit of practice, you'll be creating complex smart queries to automatically organize your bookmarks in no time. Happy organizing!