Overview
Lightning Reports define how Salesforce data is queried, grouped, filtered, and displayed. Each report is a single
.report-meta.xml
file placed under
reports//
within the project's source directory (check
sfdx-project.json
→
packageDirectories[].path
for the source root).
Critical Rules (Read First)
TOP DEPLOYMENT KILLERS — check these BEFORE generating any report:
Grouping fields in columns
— Fields in
or
must NEVER also appear in
Wrong column names
— Column names are report-type-specific. ALWAYS call MCP tools to verify (see
references/column-names.md
)
Wrong scope
— LeadList uses
org
, not
organization
Filter column dot notation
— Filter
values use FLAT names (
INDUSTRY
,
TYPE
) NOT dot notation (
ACCOUNT.INDUSTRY
is INVALID)
Multi-value picklist filters
— Use ONE
with comma-separated
(e.g.,
Technology,Financial Services
). Do NOT split into multiple criteriaItems with booleanFilter
Rule 1: Format Determines Required Elements
Show more
Installs
882
Repository
forcedotcom/sf-skills
GitHub Stars
827
First Seen
Jul 31, 2026
Security Audits
Gen Agent Trust Hub
Pass
Socket
Pass
Snyk
Pass