Error: dynamodb cannot read properties of undefined

Answered by Rafal Wilinski
What's Causing This Error
This is an error that you may run into in the Node.js environment. You may face it locally or even in a Node.js Lambda function. There is no true cause for this error, but it is typically caused when trying to read an item from DynamoDB when nothing is returned from the query or scan.
Consider the snippet below.
const { Items = [] } = await documentClient.scan(scanParams).promise();
// will throw error if there is no error for 0th index.
console.log(Items[0].id);
Solution: Here's How To Resolve It
Try a few of the solutions listed below to see if they will solve your error.
- Ensure that the item you're trying to read from DynamoDB exists. You can use the optional params -
item?.id. - Ensure that you have implemented proper error handling to help your application recover from such errors.
Other Common DynamoDB Errors (with Solutions)
- DynamoDB Network Error: self signed certificate in chain
- DynamoDB Error All Attributes Must Be Indexed
- dynamodb: one or more parameter values were invalid: type mismatch for index key
- dynamodb global secondary index does not project
- dynamodb unknown error
- DynamoDB type is not supported
- DynamoDB parameter validation failed
- DynamoDB is not showing all columns
- DynamoDB failedbatch retry
- is not authorized to perform dynamodb:* on resource
- ExpressionAttributeValues contains invalid value: One or more parameter values were invalid: An AttributeValue may not contain an empty string
- com amazonaws services dynamodbv2 model resourcenotfoundexception
- DynamoDB Delete Not Working
- KMS Key Access Denied Error DynamoDB
- DynamoDB Duplicate Key Error
Dynobase is a Professional GUI Client for DynamoDB
Start your 7-day free trial today
Product Features
DynamoDB Tools
DynamoDB Info
© 2026 Dynobase