dynobase-icon
Dynobase

Question: What are the naming conventions in DynamoDB?

Rafal Wilinski

Answered by Rafal Wilinski

Last updated: October 23rd, 2026

Answer

DynamoDB table and index names must contain 3 to 255 characters, using letters, digits, underscores, hyphens or dots. Names are case-sensitive. A table name must be unique within one AWS account and Region, not across AWS globally.

Use a predictable convention such as orders-prod and orders-dev, or let infrastructure tooling generate physical names. Keep customer information and secrets out of resource names. Index names such as ByCustomerAndDate describe the lookup they support; choose one consistent convention across your application.

Attribute names follow different rules. They use UTF-8, must be nonempty and generally must be smaller than 64 KB. Table and index key attribute names have a 255-character API limit. For INCLUDE projections, keep each projected non-key attribute name within 255 UTF-8 bytes. Attribute names contribute to item size, so readable, concise names are preferable to unnecessarily long ones.

Reserved words and punctuation are allowed in attribute names, but need aliases in expressions. For example, map #state to status in ExpressionAttributeNames and use #state in the expression. A dot inside a literal attribute name must also be aliased to distinguish it from a nested document path. The reserved-word checker helps spot these cases.

Do not confuse a key's name with its value. Key attributes must be String, Number or Binary. A partition-key value need only be unique when it is the whole primary key; with a sort key, the pair is unique. Names such as PK and SK are conventions, not DynamoDB requirements. See DynamoDB keys for examples.

Source: AWS naming rules.

Dynobase is a Professional GUI Client for DynamoDB

Start your 7-day free trial today

Product Features

Download
/
Changelog
/
Pricing
/
Member Portal
/
Privacy
/
EULA
/
Twitter
© 2026 Dynobase
+
Still using AWS DynamoDB Console?
Try Dynobase to accelerate your DynamoDB workflow. Start your 7-day free trial today.