arrow_backBack to Chapter

Module: Debug your field

Interactive Module
infoYou're viewing as a guest — progress won't be saved. Sign in to track your progress.

Debug your field

Learn how to debug things, check permissions, page layouts and make your field really usable.

Closing the Visibility Gap

In the previous module, you successfully deployed a new custom field to Salesforce using Cursor. However, in the world of Salesforce metadata, existence does not equal visibility. If you log into your org right now, you likely won't see your field on the record page. This is because Salesforce follows a 'secure by default' model where new fields created via API/CLI often lack Field-Level Security (FLS) permissions and are not automatically assigned to Page Layouts.

Agentic Debugging vs. Manual Toggling

Instead of hunting through the Setup Menu to find the right checkbox, we use Cursor to inspect the metadata dependencies. To make a field usable, we must address two primary blockers:

  • Permissions: Ensuring the Admin or SE profile has 'Edit' and 'Read' access in the Profile or Permission Set metadata.
  • Layout Assignment: Identifying which specific Page Layout is being utilized by the application you are demoing (e.g., the Service Console) and programmatically inserting the field into the XML definition.

By using Cursor to 'read' the app configuration, we can determine exactly which layout needs modification without guessing or clicking through every layout in the Object Manager.

Test Your Understanding

Complete this check to unlock the Discovery Checklist and Implementation Guide.

bolt

Knowledge Check

You've deployed a field but it isn't appearing on the record. Which two metadata components are the most likely culprits?

Which CLI command would you use to deploy only the changes made to the Admin Profile?

Discovery Milestones

lockCOMPLETE QUIZ TO UNLOCK
lock

Verify and apply Field-Level Security

Finish previous step to unlock

lock

Identify the Service Console Page Layout

Finish previous step to unlock

lock

Make sure the field is on the appropriate page layout

Finish previous step to unlock

lock

Fix Cache Issues

Finish previous step to unlock

lightbulb
Expert Guidance

Work through each milestone in sequence. Opening the Implementation Blueprint for each step will give you the production-ready patterns you need to apply the concept immediately.