Loading

Resolving the "The Instruction Is Not Available" Error When Running a Macro in Salesforce Service Cloud

Fecha de publicación: May 19, 2026
Descripción

When running a Macro in Salesforce Service Cloud, the error "The instruction is not available" appears for one or more macro instructions. This error indicates that the macro is targeting a UI element, field, or action that is not accessible to the current user.
Common causes include changes to the page layout, changes to user permissions or object access, or changes to Field-Level Security (FLS) settings.
Important: Every instruction after the first failing instruction will also display this error. This does not mean all instructions have failed. Focus your investigation on the first instruction that fails and work down the list from there.

Solución

Use the following sections to identify which configuration change is causing the macro instruction to fail.

Changes on the Page Layout

The macro executes as long as its target element exists on the current screen. If the page layout was modified after the macro was created, the target may no longer be available.
Common page layout changes that can cause this error:

  • A publisher action was removed from the feed layout.
  • The Knowledge sidebar was removed from the Service Console components.
  • The relevant field or quick action was removed from the layout for a specific profile.

Resolution: Review the page layout for the user's profile and ensure the macro's target elements are still present.

Changes on Object Access (Read, Create, Update, Delete)

The user's profile may have had object-level permissions changed since the macro was created. If the user no longer has access to Create, Edit, or Delete records on the target object, the macro instruction will fail.
Resolution: Review the user's profile permissions for the objects referenced in the macro instructions.

Changes on Field-Level Security (FLS)

Field-Level Security (FLS) controls which fields a user can see and edit on an object. If FLS was changed after the macro was created, the target field of the macro instruction may no longer be visible or editable for the user.
Resolution: In Setup, review the FLS settings for the fields referenced in the macro for the user's profile.

Changes in Preferences or Permissions

Some macro instructions depend on specific user permissions or org preferences (for example, access to Knowledge, Case Email, or Feed Actions). If any of these preferences were recently changed, review them against the macro's required targets.
Note: Two users may see the same macro differently — one with and one without the error — if their page layouts, object access, FLS settings, or preferences differ. Compare these settings between an affected and an unaffected user to identify the difference.

Número del artículo de conocimiento

000387893

 
Cargando
Salesforce Help | Article