Question


Cognizant Technology Solutions
GB
Last activity: 30 Apr 2025 11:55 EDT
Custom components not displaying in app studio
We are trying to build a custom DX component. The custom component is being published properly into Pega. However the component is not showing up in the App studio. I did all the checks as suggested in different PDN articles but none of them are working. Need help on this.
***Edited by Moderator Ellen to add Capability tags***
-
Reply
-
Share this page Facebook Twitter LinkedIn Email Copying... Copied!


Pegasystems Inc.
GB
⚠ This is a GenAI-powered tool. All generated answers require validation against the provided references.
⚠ This is a GenAI-powered tool. All generated answers require validation against the provided references.
Advanced Troubleshooting Steps for Custom Components Not Displaying in App Studio
1. Verify Component Registration and Authentication
- Ensure the component is correctly registered in your application's definition
- Navigate to Dev Studio > [Your Application Name] > Definition
- Expand the Advanced section and check that the component is listed under Enabled components
- Verify that the authentication profiles for the component are correctly configured:
- For Constellation DX components, check the KM_OAuth_Enduser authentication profile
- For admin components, verify the KM_OAuth_Admin authentication profile
2. Check UI Runtime Settings
- In Dev Studio, click on your application name, then Definition
- Expand the Advanced section and review the UI Runtime settings
- Ensure the correct UI option is selected:
- For React-based UI, select "Pega Platform (Constellation UI)"
- For server-rendered UI, select "Pega Platform (Traditional UI)"
- After making any changes, click "Generate routing table" and save the changes
3. Verify Dynamic System Settings
- Check the following Dynamic System Settings in Dev Studio:
- ConstellationPegaStaticURL
- ConstellationSvcURL
- Incorrect configuration of these settings can prevent components from loading properly
4. Clear Caches and Restart Services
- Clear your browser cache completely
- In Dev Studio, navigate to System > Operations > Clear Caches and clear the relevant caches
- If possible, restart the node or service to ensure all changes take effect
5. Check Component Publishing Process
- For Constellation DX components, the publishing process involves:
- Bundling all assets together using Webpack to create a gzipped package
- Connecting with Pega Infinity using a Pega service to create/update a Rule-UI-Component
- A declare trigger on Rule-UI-Component performs the onward publish to the Constellation Service
- Verify that each step of this process completed successfully
6. Examine Access Group Permissions
- Ensure your user account has the necessary permissions to view the custom components
- Check that the component is available in the correct access group
7. Verify Application Ruleset
- Confirm that the custom component is included in the correct ruleset
- Ensure the ruleset is available in the application you're working with
8. Check for Errors in Logs
- Review the error logs in Pega to identify any issues during component loading
- Use the Tracer tool to monitor the component's behavior during runtime
9. Test in Different Environments
- If possible, test the component in a different environment (development, staging)
- This can help determine if the issue is environment-specific
If you've already tried all these steps and are still experiencing issues, could you please provide more details about:
- The type of custom component you're working with (widget, template, field)
- Any error messages you might be seeing in the console or logs
- The specific version of Pega Platform you're using
References: Troubleshooting DX components Constellation DX components in App Studio Publishing the widget Authenticating Pega Infinity Server user access


Cognizant Technology Solutions
GB
@MarijeSchillern - Have checked all of these. I am not sure if steps 1 and 2 are right as it is regarding a component ruleset as opposed to a custom component. I have checked all the other steps.
- The type of custom component you're working with (widget, template, field) - field
- Any error messages you might be seeing in the console or logs - there is no error when publishing , its just that the same doesn't reflect in App Studio.
- The specific version of Pega Platform you're using - Infinity 24.1


Pegasystems Inc.
GB
@Samiran Manna i think it would be best if you log this as a support incident via the MSP. Please provide the INC id here so that we can help track it.


Pegasystems Inc.
CA
Could you please confirm that you can see the Component in Rule-UI-Components once after publishing? Are you using 3rd party libraries in your Custom component?
Updated: 31 Mar 2025 15:59 EDT


Cognizant Technology Solutions
GB
@RameshSangili yes we can see the component as an instance of Rule-UI-Component class. We are not using any third party libraries. I have also checked the QP - syncConstellation and it is working. the DSS we are using is ConstellationSvcURL with value of https://prod.constellation.pega.io/c11n-appstatic. When we go to the App Studio and looking at Display As we can see some old components showing up but the new components we created are not showing up. We have no clue how to debug this. Is there a way to figure out where the Display As dropdown is being populated from?
Also did npm run list and it does show up all the components.
Thanks and Regards,
Samiran.


Cognizant Technology Solutions
GB
Any updates on this?


Cognizant Technology Solutions
GB
Haven't got any acceptable solution yet...please help
Updated: 30 Apr 2025 11:55 EDT


Pegasystems Inc.
GB
@Samiran Manna as stated before, I think it would be best if you log this as a support incident via the MSP.
Please provide the INC id here so that we can help track it.