Work with Custom Lightning Components

Learning Objectives

After completing this unit, you’ll be able to:
  • Install a custom Lightning component
  • Use your mobile device to preview your app in the Salesforce mobile app

Custom Lightning Components in the Lightning App Builder

Creating a custom Lightning component requires programming skills. Or, you can install an existing Lightning component from the AppExchange.

Important

Important

Point-and-click admins, you can do this unit! We’re providing you with a custom component that’s already configured. So don’t worry. You don’t need programming skills to earn this badge.

To learn how to create a custom Lightning component, see the Lightning Components module.

Custom components in your org that are configured for use in the Lightning App Builder appear in the Lightning Components pane.

Lightning App Builder component pane

Your custom Lightning components don’t automatically work on Lightning pages or in the Lightning App Builder. To make a custom component usable in both, you need to:
  1. Configure the component and its component bundle so that they’re compatible with the Lightning App Builder and Lightning pages. For details, see the Lightning Components Developer’s Guide.
  2. Deploy My Domain in your org.

The custom component we’re providing for this module has already been configured for the Lightning App Builder.

My Domain Is Already On in Your Trailhead Playground

Do not attempt to turn on My Domain, or change its settings, in your Trailhead Playground. By default, My Domain is already active in every Trailhead Playground.

My Domain name highlighted in a Trailhead Playground URL

In your production org, My Domain lets you create a subdomain unique to your organization. With My Domain, you replace the instance URL that Salesforce assigns you, such as https://na17.lightning.force.com, with your chosen subdomain, for example, https://mydomainname.lightning.force.com.

My Domain is required to create custom Lightning components and set up single sign-on (SSO) in an org. To learn more about My Domain, check out this knowledge article. To learn how to activate it in your production org, see the User Authentication module.

Install a Custom Lightning Component

We’ve provided a custom Opportunity Alert Lightning component that you can add to your Lightning page. Let’s install it into your org.

  1. Copy and paste https://login.salesforce.com/packaging/installPackage.apexp?p0=04tj0000001mMYP into the navigation bar of your browser, and then press ENTER.
  2. Click Install.
    The installation takes a few moments.
  3. Click Done.

After the installation completes, it’s time to add the component to your page.

Add the Custom Lightning Component to Your App Page

  1. From Setup, enter App Builder into the Quick Find box, and then click Lightning App Builder.
  2. Click Edit next to the Top Accounts and Opportunities page.
  3. Add the OpportunityAlert component above the List View component.
  4. In the properties pane, change Days Since Last Modified to 6.
    Did you notice that the text inside the component changed to match the new field value?
  5. Click Save.
    Tip

    Tip

    Because you activated the page previously, you don’t have to activate it again.

All right! The changes you made are immediately available in Lightning Experience and the mobile app. Let’s see what the page looks like now.

Test the Custom Component

We’ll look at it in the Salesforce mobile app first.
  1. Open the app on your mobile device.
  2. If necessary, log in using your Trailhead Playground credentials.
  3. Go to the Top Accounts and Opportunities page.
    Test Your Custom Component in Salesforce1
  4. Go back to your org and view the Top Accounts and Opportunities page in Lightning Experience.
    Because you created the page using the Two Columns template, it uses the two-column format when you view it on the desktop or a tablet.
    Test Your Custom Component in Lightning Experience
Congratulations! You used the Lightning App Builder to create an app page, personalize your Lightning Experience Home page, and customize a Lightning Experience record page.

You’ve got the skills now to make the Salesforce mobile app and Lightning Experience handier and more powerful for your users. Go forth and customize!

retargeting