Global search gives you a way to search all your catalogs, songs, recordings, and files from one central location. This document will help you learn how to use search operators. But before you learn about the operators, you need to know the search attributes.
Search attributes
Think of search attributes as labels to search by. Here are all of the possible attributes:
Song attributes
| Search attribute | Description |
| title | Song title. |
| creation | Creation date on song project. |
| modified | Date when song was last updated. |
| added | Date when song was added to Songspace. |
| member | Member on a song or playlist. |
| description | Description field on a song project. |
| genre | Genre field on a song project. |
| lyrics | Lyrics field on a song project. |
| released | Release date on a recording on a song project. |
| publisher | Publisher on a writer on a song project. |
| tag | Tag field on a song project. |
| writer | Writer on a song project. |
| note | Note field on a song project. |
| mp3Comment | iTunes MP3 Comments field on a song project. |
|
userRating |
The Star Rating on a song project. |
|
ascapId |
Song Identifier field on a song project. (Business Users Only) |
|
bmiId |
Song Identifier field on a song project. (Business Users Only) |
|
ccliId |
Song Identifier field on a song project. (Business Users Only) |
|
customId |
Song Identifier field on a song project. (Business Users Only) |
|
hfaLicense |
Song Identifier field on a song project. (Business Users Only) |
|
iswc |
Song Identifier field on a song project. |
|
maestroId |
Song Identifier field on a song project. (Business Users Only) |
|
mriLicense |
Song Identifier field on a song project. (Business Users Only) |
|
sesacId |
Song Identifier field on a song project. (Business Users Only) |
|
writerSplitsTotalPercent |
The sum of writer splits on a song project. |
|
recordingsCount |
The number of recordings on a song project. |
Recording search attributes
| Search attribute | Description |
| album | Album title on a recording. |
| artist | Artist field on a recording. |
| ISRC | ISRC field on a recording. |
| UPC | UPC field on a recording. |
| label | Label field on a recording. |
| released | Release date on a recording. |
| title | Recording title. |
| created | Date the recording was created on Songspace. |
| modified | Date the recording was last updated. |
| length | Length of recording. |
| BPM | BPM field on a recording. |
File search attributes
| Search attribute | Description |
| description | File description. |
| title | File title. |
| created | Date the file was created on Songspace |
| modified | Date the file was last updated. |
Catalog search attributes
| Search attribute | Description |
| title | Catalog title. |
| created | Date the catalog was created. |
| modified | Date the catalog was last updated. |
| member | Catalog member. |
| description | Catalog description. |
| contactInformation | Contact information field on a catalog. |
Search Operators
Now that you know the search attributes, it is time to learn how to use them!
| Search type | Description | Syntax | Example | Results |
| Basic search | If you want to search for a word(or words), simply type those words into the search field. | word1 word2 word3 | Roses are red | This search will return any asset containing the words: roses, are, red. |
| AND operator | You can also use the AND operator to search for specific words. | word1 AND word2 AND word3 AND.... | roses AND red | This search will return any asset that contains both the word roses and the word red. |
| Grouping operator | Using parenthesis to group words together can save you the trouble of typing out AND over and over again. | attribute:(word1 word2) | genre:(blues punk jazz) | This search will return all songs with the genres of blues, punk, and jazz. *Results would be the same as typing out: genre:blues AND genre:punk AND genre:jazz. |
| OR operator | Maybe you’re trying to remember a song, but you can’t remember exactly what it is. Were the roses red or violet? | word1 OR word2 OR word3 OR.... | roses OR red | This search will return assets matching red or violet. |
| Quotation marks | If you’re looking for an exact phrase, put quotation marks around your phrase. | "word1 word2 word3" | "roses are red" | This search will return any asset that contains that exact phrase. |
| Search using attributes | If you’re looking for a song/recording/file/catalog, you can use the specific search attribute based on exactly what you’re looking for. |
attribute:word1 attribute:”word1 word2” |
title:Demos creation:[2015-01-01 TO 2015-12-31] title:"Roses are red" |
Example 1: Returns any asset that has Demos in the title. Example 2: Returns any song with the creation date in 2015. Example 3: Returns any asset with the phrase Roses are red in the title. |
| NOT operator | Maybe you have a large catalog and you’d like to narrow down your search a bit. The NOT operator might be your answer. Putting a ‘-’ in front of a search term will exclude it from the search. |
word1 -word2 -attribute:word1 |
title:Demos -genre:blues | This search will return all results with the title of ‘Demos’ that do not have the genre ‘blues’. |
Note: Notice in example 2 when using dates, the syntax is YYYY-MM-DD.
Advanced Search Examples
Now you can combine previous search operators if you’d like!
Here are some common searches that may be a little more advanced:
| Description | Syntax | Example | Results |
| Searching for a certain song that contains certain lyrics. |
type:word1 title:word lyrics:word |
type:song title:”Take the wheel” lyrics:ford | This search will return a song with Take the wheel in the title that also has ‘ford’ in the lyrics. |
| Searching for a certain folder. | type:folder title:word1 | type:folder title:”2016 Demos” | This search will return the folder with that title. |
| Searching for genres within a date range. | genre:word1 released:[YYYY-MM-DD TO YYYY-MM-DD] | genre:blues released:[1950-01-01 TO 1959-12-31] | This search will return all blues songs that have recordings with a release date in the 1950’s. |
| Search for all songs containing a certain word that don’t have a specific tag. | type:word title:word1 -tag:word2 | type:song title:love -tag:uptempo | This search will return all songs with love in the title that aren’t tagged uptempo. |
| Search for songs that are about a topic but you want to make sure the lyrics don’t contain a certain word. | type:word title:word1 -lyrics:word2 | type:song title:truck -lyrics:chevy | This search will return all songs with truck in the title that do not mention chevy in the lyrics. |
| Search for songs written by a certain writer with a specific tag | writer:word1 tag:word2 | writer:”Bill Billiams” tag:jazz | This search will return all songs that have Bill Billiams credited as a writer that also have jazz as a tag. |
| Can’t remember how to spell a writer’s name, but know what it starts with | writer:nnn* | writer:Bil* | This search will return anything where the writer’s name begins with Bil. Meaning Bill, Billy, Billie, etc… |