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.

mood

Mood field on a song project.

theme

Theme field on a song project.

Recording search attributes

Search attribute Description
artist Artist field on a recording.
bpm BPM field on a recording.
duration Duration / length of recording.
decade Decade selected on recording.
title Recording title.
genre Genre selected on recording.
instrumental Instrumental checkbox (true / false).
instruments Instruments field on a recording.
isrc ISRC field on a recording.
key Key selected on recording.
modified Date the recording was last updated.
mood Mood field on a recording. 
originallabel Original record label field on a recording.
tag Tag associated to recording.
tempo Tempo selected on a recording.
theme Theme field on a recording.
vocals Vocals field on a recording.
release Release associated to a recording.
releaselabel Label associated to a Release that is associated to a recording. 
upc UPC/EAN field on a Release that is associated to a recording.
bonustrack Bonus track checkbox on a recording (true / false).
hidden track Hidden track checkbox on a recording (true / false).
masterrights Master Rights checkbox on a recording (true / false).
explicit Explicit checkbox on a recording (true / false).

Release search attributes

Search attribute Description
artist Artist field on a Release.
label Label field on a Release.

releasedate

Release date associated to a Release.
UPC UPC/EAN field on a Release.
catalognumber Catalog number field on a release.
title Title of Release.
format Format selected on a Release.
genre Genre associated to a Release.
modifieddate Date the Release was last updated.
notes Notes field on a Release.
description Description field on a Release.
releaseyear Release year associated to a Release.
tag Tags associated to a Release.
totaldiscs Total discs field on a Release.
totaltracks Total tracks field on a Release.

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]

Example 1: Returns any asset that has the word Demos in the title.

Example 2: Returns any song with the creation date in 2015.

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

-genre:("Blues") tag:"sad" This search will return all results with the tag "sad" 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