Using search operators

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…
Have more questions? Submit a request