Salesforce Docs Portal

Add Lightning Components as Custom Tabs in a Lightning App

Make your Lightning components available for Lightning Experience and Salesforce mobile app users by displaying them in a custom tab in a Lightning app.

Required Editions

Available in: Lightning Experience

Available for use in: Contact Manager, Group, Professional, Enterprise, Performance, Unlimited, and Developer Editions

Create Lightning components using the UI in Enterprise, Performance, Unlimited, Developer Editions, or a sandbox.
User Permissions Needed
To create Lightning Component Tabs: Customize Application

To configure an Aura component to be used as a custom tab, see the Lightning Aura Components Developer Guide.

To configure a Lightning web component to be used as a custom tab, see the Lightning Web Components Developer Guide.

Follow these steps to include your component in Lightning Experience and make it available to users in your organization.

  1. Create a custom tab for this component.
    1. From Setup, enter Tabs in the Quick Find box, then select Tabs.
    2. Click New in the Lightning Component Tabs related list.
    3. Select the Lightning component that you want to make available to users.
    4. Enter a label to display on the tab.
    5. Select the tab style and click Next.
    6. When prompted to add the tab to profiles, accept the default and click Save.
  2. Add your Lightning components to the App Launcher.
    1. From Setup, enter Apps in the Quick Find box, then select App Manager | New Lightning App.
    2. Follow the steps in the wizard. On the Navigation Items page, select your Lightning tab from the Available Items list and move it to the Selected Items list.
    3. Finish the steps in the wizard, and click Save & Finish.
  3. To check your output, navigate to the App Launcher in Lightning Experience or the Salesforce mobile app. Click the custom app to see the components that you added.

See Also