2017-01-11 13:02:45 -07:00
---
name: DefaultTTL
parameters:
- ttl
2023-01-12 16:59:42 -05:00
parameter_types:
ttl: Duration
2017-01-11 13:02:45 -07:00
---
2023-01-20 13:56:20 +01:00
DefaultTTL sets the TTL for all records in a domain that do not explicitly set one with [TTL ](../record/TTL.md ). If neither `DefaultTTL` or `TTL` exist for a record,
2017-01-11 13:02:45 -07:00
it will use the DNSControl global default of 300 seconds.
2023-01-20 13:56:20 +01:00
```javascript
2017-06-08 14:14:46 -04:00
D('example.com', REGISTRAR, DnsProvider('R53'),
2017-07-09 08:04:28 -04:00
DefaultTTL("4h"),
2017-06-08 14:14:46 -04:00
A('@','1.2.3.4'), // uses default
2017-07-09 08:04:28 -04:00
A('foo', '2.3.4.5', TTL(600)) // overrides default
2017-01-11 13:02:45 -07:00
);
2022-02-17 18:22:31 +01:00
```
2017-01-11 13:02:45 -07:00
2023-01-20 13:56:20 +01:00
The DefaultTTL duration is the same format as [TTL ](../record/TTL.md ), an integer number of seconds
2017-06-08 14:14:46 -04:00
or a string with a unit such as `'4d'` .