As a Dynamics 365 CRM developer, you might need to show data from one entity directly inside another entity’s form. For example, imagine you want to display a Contact’s details (like name, email, and phone) right on an Account’s main form, so users can view or edit them without switching screens. This is where the Form Component Control comes in handy. It lets you embed a related entity’s main form into another entity’s main form in a clean, user-friendly way.
What is the Form Component Control?
The Form Component Control is a feature in Dynamics 365 that lets you display a related entity’s main form (like Contact) inside another entity’s main form (like Account). It’s tied to a lookup field and allows users to view and edit fields directly on the same screen. This saves time and improves the user experience.
Example: If an Account has a Primary Contact lookup field, you can use the Form Component Control to show the Contact’s main form (with fields like First Name, Email, etc.) right on the Account form.
Why Use It?
- Convenience: View and edit related data without navigating away.
- Efficiency: Reduces clicks and context switching.
- Flexibility: Works across web, tablet, and phone interfaces in Dynamics 365.
Prerequisites
Make sure you have:
- System Administrator or System Customizer permissions.
- A lookup field linking the two entities (e.g., “Primary Contact” on Account pointing to Contact).
- The Form ID of the Contact’s main form (don’t worry, I’ll show you how to find it).
Step-by-Step Guide: Embed a Contact’s Main Form in an Account’s Main Form
Step 1: Open the Form Editor
- Go to make.powerapps.com.
- Open your solution > Expand Tables (Entities) > Select Account > Click on Forms.
- Open the Account Main Form.
Step 2: Add a Tab and Section
- In the form editor, go to the Insert tab.
- Add a new One Column Tab, or use an existing one (like “General”).
- Inside the tab, add a Section, and name it something like “Contact Details”.
Step 3: Add the Lookup Field
- Ensure the Primary Contact lookup field is present.
- If not:
- Open Field Explorer.
- Find or create the Primary Contact field (a lookup to Contact).
- Drag it into the “Contact Details” section.
This lookup field is critical—it tells the Form Component Control which Contact record to display.
Step 4: Add the Form Component Control
- Click the Primary Contact field.
- In the ribbon, click Change Properties.
- Go to the Controls tab.
- Click Add Control > Select Form Component Control > Click Add.
- Enable the control for Web, Tablet, and Phone.
- Select Edit (pencil icon) and on the Configure Property dialog box select Bind to a static value and then add an XML entry similar to this where TableName is the table unique name and FormID is the form ID for the main form:
<QuickForms><QuickFormIds><QuickFormId entityname=”TableName”>FormID</QuickFormId></QuickFormIds></QuickForms>
For example, to render the Contact main form on the account form, use:
<QuickForms><QuickFormIds><QuickFormId entityname=”contact”>1fed44d1-ae68-4a41-bd2b-f13acac4acfa</QuickFormId></QuickFormIds></QuickForms>
How to find the Contact Form ID:
To find the unique name for a table, select the table in Power Apps and then select Settings. The Name appears on the Edit table pane. The form ID can be found in the browser URL when you edit a form. The ID follows the /edit/ portion of the URL.
In the classic form designer, the form ID follows the formId%3d portion of the URL.
- Click OK to close and save.
Step 5: Adjust the Layout
- Select the Contact Details section.
- In the Formatting tab, increase the height and width to fit the embedded form properly.
Step 6: Save and Publish
- Click Save in the form editor.
- Click Publish.
- If you added or edited fields, go to your solution and click Publish All Customizations.
Step 7: Test the Form
- Open an Account record.
- Select a Contact in the Primary Contact field.
- You should now see the Contact’s main form embedded in the “Contact Details” section.
- Edit fields (like email) and save the Account to verify it works.
✅ Test on web, tablet, and mobile to ensure proper rendering.
Example: Embedding Contact Form in Account Form

Say you’re building a CRM system for a company that manages Accounts and their Primary Contacts. You want users to see/edit Contact fields (like First Name, Email, and Phone) directly from the Account form.
- Setup: Add the Primary Contact lookup field to a new section on the Account form called “Contact Details.”
- Control: Link the field with the Form Component Control, and configure it using the Contact’s main form ID.
- Result: When a user selects a Contact (e.g., “John Doe”), the Contact’s form appears right in the Account form. The user can edit John’s details without leaving the screen.
Tips for Success
- Correct Form ID: A wrong Form ID means nothing will display. Always double-check.
- Security Roles: Ensure users have read/write access to both entities.
- Performance: Avoid embedding overly complex forms. Simplify if the Account form becomes sluggish.
- Unified Interface: The control works best in the modern Unified Interface.
- Troubleshooting:
- Ensure a valid Contact is selected in the lookup field.
- Check that you’ve published changes.
- Confirm the Form ID matches the actual main form.
Why Not Other Methods?
- Sub-Grids: Great for listing multiple records, but not for editing a single record inline.
- Quick Create Forms: Good for new entries, but not for viewing/editing full records.
- Form Component Control: The only option that lets you embed a full editable main form inside another.
The Form Component Control is a powerful way to embed one entity’s form into another, enhancing user experience and productivity. With just a lookup and a few steps, you can give your users the ability to view and edit related data without switching screens.
Set it up, test it thoroughly, and give your users a seamless CRM experience they’ll appreciate.
👉 For more info, check out Microsoft’s official documentation: Form Component Control | Learn