{"title":"Clustered Property","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/properties/devenv-clustered-property/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/properties/devenv-clustered-property, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/properties/devenv-clustered-property","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Sets a value that indicates whether the key also defines the clustered index in the database.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Applies to","slug":"applies-to","at":217,"chars":100},{"level":2,"title":"Property value","slug":"property-value","at":317,"chars":89},{"level":2,"title":"Syntax","slug":"syntax","at":406,"chars":38},{"level":2,"title":"Remarks","slug":"remarks","at":444,"chars":222},{"level":2,"title":"Example","slug":"example","at":666,"chars":311},{"level":2,"title":"Related information","slug":"related-information","at":977,"chars":55}],"text":"> Version: _Available or changed with runtime version 1.0._\nSets a value that indicates whether the key also defines the clustered index in the database.\nBy default the primary key is configured as the clustered key.\n## Applies to\n Table key\n> NOTE\n> The Clustered property cannot be used in table extension objects.\n## Property value\nTrue if the index is clustered, otherwise false. The default is false.\n## Syntax\n```al\nClustered = true;\n```\n## Remarks\nA clustered index determines the physical order in which records are stored in the table. Using a clustered key can improve the time it takes to retrieve records.\nThere can be only one clustered key on a table.\n## Example\nThe following example defines a secondary key to be a clustered index.\n```al\nkeys\n{\n    // the first key defined in the keys section is the primary key\n    key(PrimaryKey; ID)\n    {\n        Clustered = false;\n    }\n    key(CustomerInfo; Name,Address,City)\n    {\n        Clustered = true;\n    }\n}\n```\n## Related information\nTable Key<devenv-key-properties>"}