# Detection Rule Key Value Reference Url's **URL:** \ **Category:** SIEM\ **Created:** [May 8, 2021, 8:53am UTC](https://discuss.elastic.co/t/detection-rule-key-value-reference-urls/272466 "2021-05-08T08:53:34Z")\ **Posts on this page:** 7\ **Page:** 1
**Author:** ![willemdh](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/willemdh/32/16922_2.png) [@willemdh](https://discuss.elastic.co/u/willemdh)\ **Post date:** [May 8, 2021, 8:53am UTC](https://discuss.elastic.co/t/detection-rule-key-value-reference-urls/272466/1 "2021-05-08T08:53:34Z")
Hello, After working intensively with Elastic Detections and alerting etc, I wanted to suggest that imho it would be an improvement if the reference url's were key / value instead of only the url's. Sometimes the url's are not or less human readable and it would be nice and clear to have a key which explains what the reference url is for. Also, imho it would be nice if all Elastic Detection rules would have a link to the Elastic Documentation by default. WDYT? Willem ---
**Author:** ![austinsonger](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/austinsonger/32/78994_2.png) [@austinsonger](https://discuss.elastic.co/u/austinsonger)\ **Post date:** [May 9, 2021, 8:31pm UTC](https://discuss.elastic.co/t/detection-rule-key-value-reference-urls/272466/2 "2021-05-09T20:31:25Z")
> [@willemdh](#): > > Also, imho it would be nice if all Elastic Detection rules would have a link to the Elastic by default. What are you meaning by this exactly? ---
**Author:** ![willemdh](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/willemdh/32/16922_2.png) [@willemdh](https://discuss.elastic.co/u/willemdh)\ **Post date:** [May 9, 2021, 9:23pm UTC](https://discuss.elastic.co/t/detection-rule-key-value-reference-urls/272466/3 "2021-05-09T21:23:29Z")
Sry meant the Elastic documentation of the rule ---
**Author:** ![willemdh](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/willemdh/32/16922_2.png) [@willemdh](https://discuss.elastic.co/u/willemdh)\ **Post date:** [May 18, 2021, 3:25pm UTC](https://discuss.elastic.co/t/detection-rule-key-value-reference-urls/272466/4 "2021-05-18T15:25:34Z")
@austinsonger So not a good idea? Currently when trying to add the reference links in an email action etc, it it not clear what url reference is for what exactly. For example referring to a Kibana dashboard url does not make it very clear what this dashboard is about. When a key would be added, it would things a lot more clear and usable imho. ---
**Author:** ![austinsonger](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/austinsonger/32/78994_2.png) [@austinsonger](https://discuss.elastic.co/u/austinsonger)\ **Post date:** [May 21, 2021, 11:00pm UTC](https://discuss.elastic.co/t/detection-rule-key-value-reference-urls/272466/5 "2021-05-21T23:00:29Z")
Reference URL is for the source material for building the detection rule. You would need to add the elastic detection pre-built documentation link to the each of the detections in Elastic. ![](https://us1.discourse-cdn.com/elastic/original/3X/e/3/e38fce2cc00efdd9a4e1056994e13f9994316e3f.png) Hope that helps. ---
**Author:** ![willemdh](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/willemdh/32/16922_2.png) [@willemdh](https://discuss.elastic.co/u/willemdh)\ **Post date:** [May 22, 2021, 5:23pm UTC](https://discuss.elastic.co/t/detection-rule-key-value-reference-urls/272466/6 "2021-05-22T17:23:17Z")
Thanks for your answer Austin, But that was not really my question or proposal. I know how to add url references.. 🙂 But imho i'd like to suggest making it a key value array instead of just an array or url's. Because some url's are very dificult to read by a human, for example a link to a dashboard with an id does not give any info what's the dashboard is about. A second thing was my proposal to add a reference url to the Elastic documentation of each rule by default. I wanted to check animo before making GH issues.. 🙂 Best regards, Willem ---
**Author:** ![system](https://us1.discourse-cdn.com/elastic/original/3X/1/a/1ac57faf039f6b580b3f104ef42a2a89e41014de.png) [@system](https://discuss.elastic.co/u/system)\ **Post date:** [June 19, 2021, 5:23pm UTC](https://discuss.elastic.co/t/detection-rule-key-value-reference-urls/272466/7 "2021-06-19T17:23:36Z")
This topic was automatically closed 28 days after the last reply. New replies are no longer allowed.