SoundCloud Ultimate Plugin

800x500_white-on-orangeThe SoundCloud Ultimate plugin allows musicians, podcasters or web owners who use SoundCloud to manage or display their tracks from their WordPress site.

As well providing the ability to display your tracks to the public using the SoundCloud player widget anywhere on your front-end, this plugin also gives you the control and the ability to manage, upload and delete your SoundCloud tracks via the WordPress administration panel.

The plugin’s features include:

  • Secure authentication/connection from your WordPress site to your SoundCloud account using oAuth2
  • the ability to display any of your tracks with the SoundCloud player anywhere on your blog by using a special shortcode
  • the ability to upload new tracks from your WordPress administration panel directly to your SoundCloud account.
  • View your current tracks from the WordPress admin panel which you have already uploaded to your SoundCloud account.
  • Play/preview currently uploaded tracks directly from the WP admin panel
  • Delete tracks from your SoundCloud account directly from the WordPress admin panel

Download the SoundCloud Ultimate Plugin:

Version: 1.2
Requires: 3.1
Tested up to: 3.5.1
Price: FREE


Installing the SoundCloud Ultimate Plugin

  1. FTP the wp-soundcloud-ultimate folder to the /wp-content/plugins/ directory, OR, alternatively, upload the file from the Plugins->Add New page in the WordPress administration panel.
  2. Activate the wp-soundcloud-ultimate plugin through the ‘Plugins’ menu in the WordPress administration panel.

Configuring the plugin and connecting to SoundCloud

After you’ve installed and activated the SoundCloud Ultimate plugin you will firstly need to create a SoundCloud app.

To do this, go to the plugins settings page by clicking on the “SC Ultimate” menu item as shown below:

(Figure 1)

You will then be taken to the plugin settings page.

Step 1: Creating a SoundCloud App

Click on the link in the “Before Using This Plugin Section” as shown below.


(Figure 2)

After clicking the link you will be taken to SoundCloud and asked to create an app as shown in the next few images below:


(Figure 3)


(Figure 4)

In the app creation screen shown above, do the following:

1) Enter an app name – this can be any name you want but you may want to use a name which is relevant, eg, “soundcloud-ultimate-plugin

2) Enter your website URL

3) Enter the redirect URL which was highlighted in the plugin settings which you copied earlier (see Figure 2).

4) Copy the “Client ID” and “Client Secret“. You will need to paste these in the plugin settings later.

5) Check the terms flag

6) Save your app by clicking the “Save app” button.

Step 2: Configuring the SoundCloud Ultimate Plugin


(Figure 5)

To configure the plugin do the following:

1) Paste the Client ID string which you copied when you were creating your SoundCloud app

2) Paste the Client Secret string which you copied when you were creating your SoundCloud app.

3) Save your settings.

Step 3: Connecting to SoundCloud


(Figure 6)

After entering and saving your plugin settings the final step in the configuration of the plugin is to connect to SoundCloud by allowing the app you created to have access to your SoundCloud account where your tracks will be stored.

To do this you simply click on the link in the orange box as shown in figure 6.

After clicking on the link you will see the following screen:


(Figure 7)

(Note: if you aren’t already logged into SoundCloud it will ask you to log in and then you will see the screen shown in figure 7)

Click the “Connect” button to complete the final step.

After clicking the connect button you will be redirected back to your plugin administration page as shown below and you should see the following:


(Figure 8)

After being redirected from soundcloud you will see a “connected” status as shown above.

Using The SoundCloud Ultimate Plugin

To upload, view, preview and delete tracks to/from your soundcloud account, click on the Manage Tracks tab as shown in Figure 9.


(Figure 9)

1. Uploading tracks from WordPress to your SoundCloud account

You can upload tracks from your WP admin panel directly into your SoundCloud account by entering the track details as shown by “2” in figure 9 and then clicking on the “Upload To SoundCloud” button

2. Viewing, previewing, and deleting tracks

The tracks which you currently have in your SoundCloud account will be conveniently displayed in a table as shown by “3” in figure 9.

To delete a track from your SoundCloud account, simply hover over its title and click the “delete” link as shown in Figure 10.


(Figure 10)

To play (or preview a track) you need to hover over the “Track URL” and click the “Preview” link as shown in figure 11.


(Figure 11)

This will pop up a preview window where you can listen to your track as shown below:


3. Displaying individual tracks with the SoundCloud player on the front end of your site using the plugin’s shortcode

To display a SoundCloud player with any of your tracks on a post, page or widget, simply use the following shortcode:

ScreenHunter_21 Mar. 17 14.36

Note that you need to specify the SoundCloud URL of your track. You can get this value easily by copying it from the plugin “Manage Tracks” page in the admin panel.

4. Displaying playlists (or sets) with the SoundCloud player on the front end of your site using the plugin’s shortcode

To display a SoundCloud player for your sets or playlists on a post, page or widget, you use the same shortcode as in point 3 above except that you would set the track parameter to be the URL of your set.

When you do this, you will see the SoundCloud widget which displays the tracks of your playlist (set) as shown below:


You can get the set URL value from your SoundCloud account.

102 thoughts on “SoundCloud Ultimate Plugin

  1. Hi. Your plugin is awesome. Would it possible to get the soundcloud editing functions in the front end rather than the wordpress admin panel. So display in the front end for logged in users basically. Hide for not logged in people.


  2. Hej Peter,

    I see you solve a LOT of problems, so I also have a question for you.

    My name is Maurien and I just installed Soundcloud Ultimate. I’m a musician so what better way to share your music via Soundcloud.
    When I synchronize the app, I can’t watch the preview. The following error appears:

    SoundCloud Ultimate Error: Could not display your SoundCloud track – Error code (401).

    Can you help me? I already tried it 5 times over, I tried it with different songs and off course I googled first. But there’s a lot that i do not understand.

    Hope to hear from you,


  3. Hello Peter,

    I’ve installed and triple-checked all the different settings using this plugin but every time I try to connect to the server the plugin in WordPress gives me a 401-error. I’ve retried with a fresh made application but the plugin will still give me same hassle. Any idea what might be wrong?

    Thanks in advance!

  4. Hi,

    We’re currently experiencing an error with SC Ultimate on our website:

    “Could not display your SoundCloud track – Error code (401).”

    However it has been working flawlessly for a few weeks : May you please help ?


    • Hi,
      Try the following:
      – Go to this plugin’s settings tab and first take note of the client ID and client secret.
      – Then clear the settings and re-enter them again and save your configuration
      – Then reconnect to soundcloud

          • Hi Klara,
            Firstly check your server logs to see if there are any entries related to this issue. If so please let me know what they are.

            Secondly, try the following:
            1) Delete/clear the soundcloud ultimate settings from the WP admin
            2) Log into your soundcloud account and delete the app you created previously which was used to connect this plugin to soundcloud.
            3) Go back to the soundcloud ultimate settings page in the WP admin panel and follow the instructions and create a brand new soundcloud app and configure the settings as stated in the instructions on this plugin’s settings page.

            Let me know how that goes.

  5. I’m another person who would like to resize the SoundCloud player that shows up on my Portfolio page. I see Peter saying to “wrap the shortcode inside a html “div” and supplying this example, Example:
[shortcode goes here]
    As a novice WordPress tinkerer I’m not sure exactly what to do. Can anyone help me? I want to make the player size 300×250 pixels.

    Thank you!

  6. This is a great plug in, thank you! But when I view it on mobile, it reads “SoundCloud Ultimate Error: Could not display your SoundCloud track – error code (504)”.

    Any thoughts? Thanks!

    • Hi Sara,
      Which mobile device have you tested it with?

      I tried a quick test on my iPad and my track seems to play ok.

      • I’m running the new version 1.4 but still am getting SoundCloud Ultimate Error: Could not display your SoundCloud track – Error code (0).
        Url to sound cloud audio track is tested in 3 browsers.
        SoundCloudUltimate connects and is configured/connected via WordPress interface.

          • Thanks for the reply.

            I can’t get my pre-existing soundcloud tracks into the manage tracks forms or list.

            Can the plug-in recognize tracks already uploaded to soundcloud or does the plugin assume that you uploaded the tracks via the plug-in?

          • Yes the plugin will get all tracks which are currently in your SoundCloud account.

            So just to confirm, are you seeing the message “You are currently connected to SoundCloud” in the settings page?

            When you hit the “Refresh Data” button in the Manage Tracks tab what do you see – is there any error displayed etc?

            Have you checked your server logs to see if there is any error being generated related to the SoundCloud connection? (If you can’t find your server logs ask your host provider to assist you)

  7. I am unable to resize the text widget I have inserted this shortcode into

    [soundcloud_ultimate track=]

    Any help with how to add width and height would be greatly appreciated.

  8. HI wpsolutions-hq,

    I don’t know what i’m doing wrong. Everything goes right until I am at ‘click the connect button to complete the final step’. The app says: Soundcloud Ultimate Error: Could nog process the request – Error code (0). For a image: [].

    Kind regards,


    • Check with your host provider and ask them if your account has safe_mode or open_basedir enabled in php.ini?
      These need to be disabled and if either one of these are enabled it will affect the correct operation of the cURL functionality which this plugin needs to operate correctly.

    • Hi @Elliot,
      Your shortcode has a mistake in it.
      You are missing the closing double-quote. Alternatively, you can remove the double-quote just after the track= part.

  9. Hi, I’m trying this great plugin, but I think I’ve found a bug, maybe a SC bug? I’m asking you if you can confirm. :)

    This is the url of my SC set:

    This is the shortcode: [soundcloud_ultimate track=]

    In my page ( I can view only one track.

    The track link is:

    So I think that SC cut the url and shows only that track. I’ve debugged your plugin (I’m a developer) and I didn’t found any bug, until it return the html code that has the bug. Any thoughts?


    • Hi Andrea,
      I just tried a similar test and I was able to see the same problem as you.
      I then realised that in my playlist I had only one track which was “public” and the other was “private”. Hence the playlist shortcode was only showing the “public” track and not the “private” one.
      After setting all tracks to “public” I then noticed that the shortcode was displaying ALL tracks in my playlist.
      I hope this helps you with your issue.

  10. Hi there. Thanks for the app!

    I saw a similar question posted earlier, but haven’t been able to resolve this problem. I’d like to display the player in different size. I placed the shortcode in a div with a unique class that is the size I want, but the player doesn’t resize–it just overflows out of the div. Right now I’m having to use an “overflow=hidden” to keep it from flowing out of the div, which makes it impossible to see the tracking slider or really much of anything besides the play button. Is there anyway to get the player to resize into a more compact view? Thanks!


    • Hi John,
      Can you please post a link to an example of a player widget which is having the resize problem so I can take a look at the CSS?

        • In the “SoundCloud Connection Status” section there should be a button/link called “Click Here To Connect To SoundCloud”.
          Did you click it? If not, click it and then you should be able to connect.

          • Yes , I did. Then I directed to Soundcloud. Cliked the connect button. Then I back linked to my wordpress plugin page. Still disconnected.

          • I did peter. After that I was redirected tot Soundcloud . clicked on the connect button en then redirected to the WP plugin page. Stil message “You are currently disconnected from SoundCloud.” is shown.

            tried it a several times…..

          • Try the following:
            1) Clear the settings in the plugin
            2) Login to your soundcloud account and delete the souncloud app and create a brand new one.
            3) Then go back to the plugin and start the configuration again.

            Be careful to read the instructions closely and make sure you copy and paste the correct client ID and secret from your soundcloud account.
            I’ve done several tests on two separate sites and I don’t seem to have any issues connecting to soundcloud.

  11. Hi, I recently installed the SC Ultimate Plugin and love it, except for the fact that now my music page on my website takes 15 seconds to load!! Is there any way I can get rid of this? I love this plugin and don’t wanna get rid of it, but if its gonna bog down loading times like that I will have to find another music solution. See for yourself: … Please have a solution for me, this plugin is perfect other than that minor issue :(

  12. Hi, I followed the step-by-step instructions for installing the plugin, but in the end he continued to present the following sentence: “You are currently disconnected from SoundCloud.”

    Even so, I inserted the code in the post, and the following message appeared:

    “SoundCloud Ultimate Error: You need to authenticate your connection to the SoundCloud API.
    Please go to the SoundCloud Ultimate plugin settings and configure your API credentials.”

    What to do?

    • Hi Ademivaldo,
      The first thing I would advise you to do is to double check that you have entered the correct “Client ID” and “Client Secret“.
      If these are not correct then the plugin will not be able to authenticate with the soundcloud server.

  13. Hi folks,

    Loving the plugin thanks! But having a weird error when embedding in a post. I’m connected up successfully to my SC account, but when I embed using the shortcode in a post like this:

    [soundcloud_ultimate track=]

    ..I’m getting the following error in red when I view my post:

    “SoundCloud Ultimate Error: The track you specified in the shortcode does not exist in your account.”

    I’ve checked the URL, which comes straight from my “Manage tracks” on the dash, I’ve tried with https also, still same error. The track is definitely there (it’s a private sound, so the following URL shouldn’t work for you, but works fine for me once I’m logged into SC.

    Any suggestions please?

    Many thanks,


  14. Is there a way to display private tracks using this plugin? I’ve used other plugins where I just needed to specify the “secret token” from soundcloud. Is there any way to do that with this??

  15. Quick question. It says “the ability to upload new tracks from your WordPress administration panel directly to your SoundCloud account”, yet unless I am mistaken it seems to go through the WordPress Media Library – thus bumping into upload & storage limits.

    Is there any way to work around this, so the upload does go straight to Soundcloud? For us this would be ideal, since we’ve got multiple podcasters who as such would be able to upload to an account without having to share passwords all around…

  16. When I initially commented I appear to have clicked on the
    -Notify me when new comments are added- checkbox
    and from now on whenever a comment is added I get 4 emails with the same comment.
    There has to be a means you are able to remove me from that service?
    Thank you!

  17. I tried this plugin as I thought it had everything I needed. I followed all instructions but like others on this page I received the 302 error.

    I am running WP 3.6.1

    I tried all solutions listed to no avail. I had to uninstall it and try another plugin.

    If ever a solution to this problem becomes available I will go back to it.

  18. Hi, after installing you’re plugin with a custom theme, it seems to displace an entire div from the header. This is before I have linked my SC account or started any setup at all. If I deactivate the plugin this disappears.

    Any ideas?


    • Hi Simon,
      I’ve just checked the soundcloud API documentation and it appear that it is possible by setting a special parameter (auto_play).
      I will make an update of my plugin to include this functionality hopefully within a week.

  19. Hi I’m getting the same message as the person before me:

    “SoundCloud Ultimate Error: Could not display your SoundCloud track – Error code (302).”

    I own my own Dedicated Server and I can ensure you that PHP Safe Mode is off.

    Now before you go asking me the questions that I know you’ll ask:
    Yes I am running in https:// by default. My website is secured with a GeoTrust Quick Premium SSL Certificate.

    I’m running a CentOS 6 Server with Plesk 11.0.9 installed as a CPanel.

    On observation of the components, I can tell you that the specific distro of PHP that is installed is: 5.3.3-23.el6_4, which means I am runnin PHP Version 5.3.3

    I believe this should give you enough information. I would like to know what is causing this as I need soundcloud functionality for my website.

    Looking forward to your reply,
    Kind Regards,

    • On further inspection of your PHP code, I can see that in your main file on line 133:

      echo ‘SoundCloud Ultimate Error: Could not display your SoundCloud track – Error code (‘.$e->getHttpCode().’).‘;

      Now after further digging into your code I opened up the Soundcloud.php file and saw that the exception is thrown depending on a bool set by a function called _validResponseCode which simply uses a regular expression to catch any HTTP codes within the 200 range. Now as far as I am aware, a 302 HTTP code means Found which means it has the data.

      So unless I’m greviously mistaken shouldn’t the app work?

  20. Question: I have seen a lot of SoundCloud plugins now and they all look great but from studying their features I cant help but wonder if what i’m looking to achieve is actually possible. I am not a musician nor do I upload my own personal sounds on to my SoundCloud page. As a blogger I use SoundCloud to discover new music and use the “Like” and “Repost” buttons to create a stream within my SoundCloud profile which has the list of all the songs I have “liked” and “reposted” as the months go on, which when played continue to play through each song on the list. What I was wondering was, is there a plugin or a way that I can integrate SoundCloud so that a widget/plugin on the sidebar of my WordPress site worked in the same way, that didn’t play my sounds but the sounds I have “liked” or “reposted” like they do on my SoundCloud profile? Someone put me out of my misery!

  21. Hi

    Since two days I try to work with your Plugin. First there was an error on our server settings (eg. safe mode and other things); so I couldn’t connect the Plugin with our Soundcloud-Account. Now the following error appears when I put the shortcode into a page and watch this page in preview:

    »Warning: curl_setopt_array() [function.curl-setopt-array]: CURLOPT_FOLLOWLOCATION cannot be activated when safe_mode is enabled or an open_basedir is set in […]/wp-content/plugins/soundcloud-ultimate/includes/Services/Soundcloud.php on line 919

    SoundCloud Ultimate Error: Could not display your SoundCloud track – Error code (302).«

    Unfortunately, i don’t understand the code @ line 919 (I think it’s some reference to another “place”).

    Further more the authorization for the folder “Soundcloud” is set to 755, for the soundcloud.php, the exception.php and version.php (the last two files are in the soundcloud-folder) are set to 644. Does it help somehow? Or does my problem not concern this settings?

    Can somebody tells me what to do or what the error code 302 means?

    Thanks for your help!


    • Hi Peter,
      According to the error you are getting I still think the problem lies with your server settings.

      Looks like “safe mode” is enabled and you should talk to your hosting provider to disable this if possible.


  22. Hi,

    This is great plugin so many thanks!

    I’ve managed to set everything up and working, I’d just like to be able to customise the colours of the player, in the same way you can from within soundcloud when setting up widgets.

    Is this possible?


  23. Hi,

    How to display this sets is ordering by create date / latest posting on soundcloud
    and my shortcode is going to be like this
    [soundcloud_ultimate track=]

    any advices?


  24. Hi
    I have a friend that has a Membership site and is selling his recordings from SoundCloud. All the tracks and sets are NOT public.
    On his “Thank You page” – Customer are presented with the options to play the files (listen) and DOWNLOAD them…
    I need a HTML5 player (SC account is set to use html5) but I found no evidence here?)

    Please advise if possible :)


    • Hi,
      Yes, the SoundCloud Ultimate plugin will display the HTML5 soundcloud player.
      I hope that answers your question.

  25. Hi we are currently experiencing very slow load times of our soundcloud tracks using this plugin, the page can take up to 5 minutes to load? And sometimes does not load at all, How many tracks in total would you recommend having on a page?

    Many thanks in advance

    • Hi Tony,
      Are you referring to the amount of time it takes to list the tracks in the plugin’s “Manage Tracks” tab?
      How many tracks do you currently have in your SoundCLoud account which you are trying to view via this plugin?

        • Hi Tony,
          Yes I see what you mean.
          I suspect that the problem may lie more with the type of browser than anything else.
          For instance FF and Chrome are horrendously slow when trying to load your pages.
          However, Opera is amazingly quick – (try it for yourself!).
          Also see the first comment here:

          In meantime I will investigate to see if anything can be done to speed things up.

          • Ok many thanks, i was wondering if dropping the amount to 5 per page would help but also double the amount of pages we are using for tracks

            Cheers again

  26. Hi,

    Id like to add on my wordpress a seperate page just for the user to hear all my music. I also want to be able to select, ” classical” and all classical to show up. Exactly as well as selecting” Bethoven” and all of his tracks will show up.

    This is as example of what i want, i have seen it before but am looking for
    the plugg in.. Thanks, anyhelp will do


    • Hi,
      The soundcloud ultimate plugin doesn’t really do what are you asking but having said that….
      You can group your music into playlists within soundcloud and then display the playlist on one of your wordpress pages by using the shortcode from the soundcloud ultimate plugin.

    • Hi,
      Yes you should be able to wrap the shortcode into a div tag and you can set the width and height to whatever you want by using some simply css code .
      Alternatively if you wish to display the play in a sidebar widget just put the shortcode inside a “text” widget and the soundcloud player will automatically conform to the size of the of the widget containing the player.
      I hope that helps.

      • I have a related question: when I put the shortcode in a “text” widget, it displays the shortcode instead of the players. How do I get a sidebar widget to display the players??


  27. The “settings” page and “manage tracks” pages on my site are completely blank after installation. What is that about? How do I set it up?

    • Hi Alec,
      In most cases the cause of a “white screen of death” in WordPress environments is due to an exhaustion of memory.
      You should check your hosting server logs to see if there are also any errors being logged which might share some more light into the problem.
      Also, you can try increasing the memory allocated for wordpress by modifying the wp-config.php and adding the line:
      define(‘WP_MEMORY_LIMIT’, ’64M’);
      If this doesn’t fix it you should contact your hosting provider to see what they can do for you.

  28. Hi
    Thank you for the plugin – I hope I can get it to work.
    I also get an error when puting the code as above on a page:
    Warning: curl_setopt_array(): CURLOPT_FOLLOWLOCATION cannot be activated when safe_mode is enabled or an open_basedir is set in /home/virtual/ on line 919
    SoundCloud Ultimate Error: Could not display your SoundCloud track – Error code (302).

    Thanks, Heidi

      • Hi Heidi and Mike,
        The issue you are seeing is actually related to your hosting server.
        It appears that your server has a feature called “safe mode” which has been enabled. This feature is something which was present in older versions of PHP (ie, before v 5.3.0). Safe mode is deprecated in PHP 5.3.0 and is removed entirely from 5.4.0.

        So in summary in order to fix this error you can ask your hosting provider to disable “safe mode” which must done in the PHP ini file, or find a better hosting provider with a more up to date PHP version.

  29. Hi,
    I did the app/account sync and used this short code into a page:
    [soundcloud_ultimate track=]

    I received this error:

    Warning: curl_setopt_array() [function.curl-setopt-array]: CURLOPT_FOLLOWLOCATION cannot be activated when safe_mode is enabled or an open_basedir is set in /home/mikebond/domains/ on line 919
    SoundCloud Ultimate Error: Could not display your SoundCloud track – Error code (302)

    Could anyone please tell me how to fix this?

  30. Hey, what’s the shortcode for sets? You are mentioning “Groups/Sets” in the height parameters under “Settings”, so I assume there’s the option to pull in a set. But I keep getting an error when I try…
    [soundcloud_ultimate set=]
    [soundcloud_ultimate track=]

    • Hi,
      To display the SC widget for sets all you need to do is to set the “track” parameter in the shortcode to be the URL of your set.

      For example, if my SoundCloud set has the URL “″, then the shortcode will be as follows:

      [soundcloud_ultimate track=]
      Let me know if you have any further questions.

Leave a Reply

Your email address will not be published. Required fields are marked *

1 + nine =

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>