{"record":{"id":"6d35fab8c02aac43","repo":"n8n-io/n8n","slug":"no-importable-properties-found-please-check-the","errorCode":null,"errorMessage":"No importable properties found. Please check the --include flag.","messagePattern":"No importable properties found\\. Please check the --include flag\\.","errorType":"exception","errorClass":"UserError","httpStatus":null,"severity":"error","filePath":"packages/cli/src/commands/import/credentials.ts","lineNumber":433,"sourceCode":"\t\tconst unknownProperties = properties.filter((property) => !knownProperties.has(property));\n\t\tif (unknownProperties.length === 0) return;\n\n\t\tthis.logger.warn(\n\t\t\t`Ignoring unknown properties from ${flagName}: ${unknownProperties.join(', ')}`,\n\t\t);\n\t}\n\n\tprivate filterCredentialProperties(\n\t\tcredential: Partial<CredentialsEntity>,\n\t\tinclude?: string[],\n\t\texclude?: string[],\n\t): Partial<CredentialsEntity> {\n\t\tif (include?.length) {\n\t\t\tconst includeProperties = include.filter((property) =>\n\t\t\t\tthis.isCredentialPropertyImportable(property),\n\t\t\t);\n\t\t\tif (includeProperties.length === 0) {\n\t\t\t\tthrow new UserError('No importable properties found. Please check the --include flag.');\n\t\t\t}\n\t\t\treturn pick(credential, includeProperties);\n\t\t}\n\n\t\tif (exclude?.length) {\n\t\t\tconst excludeProperties = exclude.filter((property) =>\n\t\t\t\tthis.isCredentialPropertyImportable(property),\n\t\t\t);\n\t\t\treturn omit(credential, excludeProperties);\n\t\t}\n\n\t\treturn credential;\n\t}\n\n\tprivate isCredentialPropertyImportable(\n\t\tproperty: string,\n\t): property is ImportableCredentialProperty {\n\t\tconst importableProperties = {","sourceCodeStart":415,"sourceCodeEnd":451,"githubUrl":"https://github.com/n8n-io/n8n/blob/5ac6606e81f67bb9534255570cd4e86fd8101eee/packages/cli/src/commands/import/credentials.ts#L415-L451","documentation":"Thrown by filterCredentialProperties when `--include` is provided but NONE of the listed properties are importable. Importable properties are enumerated in isCredentialPropertyImportable (credentials.ts:448-467): createdAt, updatedAt, id, name, data, type, isManaged, isGlobal, isResolvable, resolvableAllowFallback, resolverId, usageScope.","triggerScenarios":"`n8n import:credentials --input=f.json --include=foo,bar,baz` where none of foo/bar/baz are in the importable set. The filter at credentials.ts:429-431 yields zero importable properties.","commonSituations":"Typing property names; using internal/legacy field names not in the allowlist; confusion with workflow properties.","solutions":["Use only importable property names from: createdAt, updatedAt, id, name, data, type, isManaged, isGlobal, isResolvable, resolvableAllowFallback, resolverId, usageScope.","Drop `--include` to import all importable properties."],"exampleFix":"// before\nn8n import:credentials --input=f.json --include=webhookUrl,secret\n// after\nn8n import:credentials --input=f.json --include=id,name,type,data","handlingStrategy":"validation","validationCode":"const IMPORTABLE = new Set(['createdAt','updatedAt','id','name','data','type','isManaged','isGlobal','isResolvable','resolvableAllowFallback','resolverId','usageScope']);\nfunction validateInclude(include?: string[]) {\n  if (include && !include.some(p => IMPORTABLE.has(p))) {\n    throw new Error(`--include must contain at least one of: ${[...IMPORTABLE].join(', ')}`);\n  }\n}\nvalidateInclude(include);","typeGuard":"const IMPORTABLE = new Set(['createdAt','updatedAt','id','name','data','type','isManaged','isGlobal','isResolvable','resolvableAllowFallback','resolverId','usageScope']);\nconst isImportableProperty = (p: string): p is ImportableCredentialProperty => IMPORTABLE.has(p);","tryCatchPattern":null,"preventionTips":["Cross-check --include values against the importable property allowlist.","Default to omitting --include (imports everything importable) unless you need filtering."],"tags":["cli","import","credentials","flags","include","validation","user-error"],"backgroundTag":null,"analyzedSha":"5ac6606e81f67bb9534255570cd4e86fd8101eee","analyzedAt":"2026-08-12T05:26:35.080Z","schemaVersion":2},"datasetVersion":"2026-08-12T18:17:37.767Z"}