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'` .