Looking for PowerObjects? Don’t worry, you’re in the right place! We’ve been part of HCL for several years, and we’ve now taken the final step in our acquisition journey: moving our website to the HCL domain. Nothing else is changing – we are still fanatically focused on Microsoft Business Applications!

PowerObjects Blog 

for Microsoft Business Applications


The How-To Guide for CRM 2011 Ribbon Customization

Post Author: Joe D365 |

In this post, we’re going to cover how to effectively approach Microsoft Dynamics CRM 2011 ribbon customization using Scott Durow’s Ribbon Workbench.  For this tutorial I am going to create a few web resources within CRM including a HTML file that can be updated by another CRM user. We’ll create a button for other CRM users to click to see news from our organization.

To get started, let’s install Scott’s solution to CRM.

First, we download the solution from the link above, then, in CRM, browse to Settings, Customization and Solutions.  Click the Import button and browse to where you saved the solution to select it. Complete the import wizard.

After the solution is imported, you will see a button to launch the tool in the ribbon of the Customizations area. The tool uses Silverlight, so if you don’t already have it installed, you will be prompted to install it.

customize dynamics crm ribbon

Now let’s start preparing the resources we’ll need to create our button. For this example, we will need the HTML, a 16 x 16 pixel image for the button, a 32 x 32 pixel image for the button and to know where we’d like to use the button.

In CRM go to Settings, Customizations and click Customize the System. In the customizations window, select Web Resources and click New. Complete the resource name, being sure to include the file extension for the type of file you’re creating. Use a meaningful Display Name, select Web Page (HTML) for the Type. When you click save, you’ll notice that CRM has created a URL for the resource.  Copy this URL to a temporary location because we’ll need it later.

dynamics crm ribbon customization

If you’re ready to create the initial HTML, you could do that by clicking the Text Editor button or by uploading a file that you already have.

Repeat the same process to upload the 16 x 16 pixel image and the 32 x 32 pixel image, selecting PNG, JPG or GIF as the Type.

We’re close to using the tool now, are you ready?

First we need to decide where in CRM we want this button. Since this button will be a corporate communications tool, I’d like the button to be on the Dashboards page, the main page that loads when my users start CRM.  Now we need to create a solution for the Ribbon Workbench to work from.

Once again we’ll go to Settings, Customizations and Solutions, but now we’ll create a solution by clicking New.  Since I want the Dashboards page and that is located on the Application Ribbon, we need to add Application Ribbon. Click Add Existing and choose Application Ribbon. Then we need to add our button images, so click Add Existing, choose Web Resource and add your two image files. When you have these components, click Save and Close.

Step 3 for CRM 2011 Ribbon Customization

OK, OK, now it’s time for the tool. As you recall the button for the Ribbon Workbench is in Settings, Customizations ribbon. Click it to load it and you will be prompted to select a solution. Select the solution you just created and it will load.

Step 4 for CRM 2011 Ribbon Customization

As you can see, there is a lot to see, but we know that we’re after the Dashboards page, so let’s click that. Now we need to give our button a command, so click Commands in the Solution Elements section, right click and click Add New. Expand the Commands section and click the new command you created, and in the Properties section, choose the lookup button next to Actions. Click Add and then click open URL Action.  Remember that URL we saved before? We need it now.  Our URL was https://myorg.crm.powerobjects.net//WebResources/new_corpcommunications.html.  We just need the /WebResources/new_corpcommunications.html part, so paste that into the Address field. Note you can pass parameters if you like. Since this is a static page we won’t need to do any of that. Click OK and you have just created a command.

Now let’s create our button.

On the far left, click Button in the Toolbox and drag it up to the location on the Dashboard Ribbon where you would like the button to appear. When you do that you will see that there us a new button under the Solution Elements and the Properties section is ready to accept more info. In the command section choose the drop down and select the command that we just created. Now let’s fill out the info we know. Click the lookup to select the images we put in the solution, give your button a label, description, provide some tool tips if you like (what a user will see if they hover over the button with the mouse).

Step 5 for CRM 2011 Ribbon Customization

The hard work is done now. When you have everything ready to go, click Publish Solution at the very top of the window and the button will be added to CRM. You may need to refresh the CRM web page to see the button after the tool has completed uploading the solution.

Whoa! Look at this! We have our new Hi Joe! button and I created a button for an existing solution, PowerGlobalSearch. When I click these buttons their web pages open up for me. Imagine the options we have!

Step 6 for CRM 2011 Ribbon Customization

This was a simple example of how to use a powerful tool. Now that you’ve got your feet wet, use your test Org to experiment with adding tabs, passing parameters, kicking off javascript, and the other features of this handy tool.

We hope you enjoyed this tutorial on creating a button in the CRM ribbon. To learn more, reach out to the CRM Experts at PowerObjects.

Happy CRM'ing!

By Joe D365
Joe D365 is a Microsoft Dynamics 365 superhero who runs on pure Dynamics adrenaline. As the face of PowerObjects, Joe D365’s mission is to reveal innovative ways to use Dynamics 365 and bring the application to more businesses and organizations around the world.

3 comments on “The How-To Guide for CRM 2011 Ribbon Customization”

  1. Hi Joe,
    I am trying to do same idea for CRM 2013 using workbench version unfortunately it is not working. I would like to display the "New Loan" ribbon button on the dashboard command bar where we can show only 5 button. I had added display rule to show up even it does not work. Could you help me on that part how to do it?

  2. i need help mate i don't understand anything about crm where should i start just to let u know i don't have any database background???

PowerObjects Recommends