关于合同定金的数额问题，这是一个涉及法律规定的具体事项，我来为您详细解答。

首先，合同定金的数额应由当事人自行约定，这体现了合同的自由原则。然而，这种自由并非无限制的，根据《中华人民共和国民法典》的相关规定，定金的数额不得超过主合同标的额的百分之二十。这一规定旨在平衡合同双方的利益，防止因定金数额过高而给一方带来不公平的风险或损失。

举个例子，如果主合同的标的额是100万元，那么定金最多只能是20万元。如果双方约定的定金数额超过了这一比例，比如约定了30万元作为定金，那么超出部分的10万元将不产生定金的法律效力。这意味着，在发生违约等需要适用定金罚则的情形时，仅能在法定限额内的20万元定金数额上进行处理，超出部分不能作为定金来罚没或双倍返还。

此外，定金合同是自实际交付定金时成立的实践合同。仅仅在合同中约定定金是不够的，必须有一方实际交付了定金，合同才具有法律约束力。同时，为了避免因约定不明确而产生纠纷，定金应当以书面形式进行约定。在书面协议中，应详细注明定金的数额、交付时间、违约条款等关键内容，以确保双方的权利和义务清晰明了。

在实际操作中，当事人在签订合同时应仔细审查并明确约定定金数额，确保其不超过主合同标的额的百分之二十。同时，在合同履行过程中，应严格区分定金与其他款项（如预付款、押金等）的性质与用途，避免产生混淆和纠纷。

综上所述，合同定金的数额虽然由当事人自由约定，但必须严格遵守法律规定的上限，即不得超过主合同标的额的百分之二十。这是为了保障合同的合法性和有效性，同时降低潜在的法律风险与经济损失。希望这个解答能够帮助您更好地理解合同定金的数额问题。