Understanding patterns

Patterns are layouts that you can copy and paste into your theme to instantly change the look-and-feel or behavior of a page.

Patterns are layouts that you can copy and paste into your theme to instantly change the look-and-feel or behavior of a page. They’re built on our powerful micro-templating system, which means they can be copied from our Pattern Library and pasted anywhere in the help center, giving you unparallelled flexibility and control.

While page templates can only make use of the objects and helpers available on a given page, patterns can render markup based on help center data (categories, sections, articles, topics and/or posts), custom data you pass to the template or data from third-party services. Our status indicator patterns are an example of displaying third-party status information from Statuspage.

System status in a badge
View code
703a2a092705363c61c9d276548a82752bcdf0d6bbc5f530ed83138f0126338c0f3342d3ae61947d208969e4f4d8cf576ede0179b4f8b0502bb92c58aab22494d49832a47f3e6324c9fccce7958263f8005c6cb6dadaa43bbd725bfff1bd298ee493c527bad34188276fc38e7a8513fccc6314a22962136c7e7a9dff62414779ec620b4291e4316eea290142a71d009a0a03282c7597be75efcaacb93798bc92fd272ae4ccfb49d8875e0ca184fce2814e44476399dd7c7ff826c1159acf51316191b43e2e5a9c21bf195851f65ff38fb949ee878a9f0dfde2ef75db6bc7432a79ad5b5e5d86ebda291fa6f293aa8b5b93df43393f2687f0360db12ff7392529fbf77bfcc9442477b19179e53e2542565a7f08bbf2d290b32eb64710b2ba4dcdba868a03092ad621aff8895d6b8c1340d2920a812d500fac6a3036c198f2756eb526b65d3fbd15c70db9daa746ab772dcb56362503f38e4ef6ccd4057ca7c63576f1e4f12e5eb35e9a4075c78177d6f1f3149a3e67c9b117ea59676db1992d14d9b43962e3f48d4bd5bc3ca116df95ec3675f60df6f9c621f5d98731bfcbf5f2519ff9ca5b4cc5c9b78885c07e57df71afa84fe6aa817c403ae307709a22c837d3a6c5211bd3af318189bb3adab8fb6f4ab69208c4999aaf821575e4e897163efb66cadc0fe3d40c06c8e8fceb10c4a0f91e41a8daf4af9cbb6787a55e7f598640427ff0897d977fde5d40996e1bff96435a073991c7fc2253513d61988a65aee9b01eb8f39af05ad3672be978497cf45fcd9d68afbbb9a43e2904aee721cb74c32b7d417384ea787a8d5fdd099f878c05cce4faeba0c780bf9068ed85b4263851f96bad58bb3b8e38f5b8571bdc43fe9d7cb0a435e66be6f3076f7f7617233bb4de0d6fe011ae3bc5a8aa325ee4be70dc9d55fc7f19376da0a8e26625bc566628b72948f7875f60698c7e44b27dfa56c6bf35587720f8cb3edef5a95ae0633a74e9fa6d69061af9a2dec5f9406d30a8001f5549a5c92b3bcdb4fbe1e42b2cdaa241f78290b59dd23ddb7546a22b7eda0f2b8cb51ef1c594bd577fac2c1d380ebdd5577e66ec5d25627944ac7b231328139591450eade954a7f42131099b7e5da342c91aa76e9cbafa6294b501797e66f18c71a9d86c18f0364af7c6ffe771909746884041eee493f57a39010553f16c430599686dd904050e47b7f75e9fec0309c3ee600ccece57309bfaf248bcb2ba647dd4903a2eb93e4c2a592e3fedd27c4ffc82129b69fa3b52b03140b002d88fff987297c22464f906bb58933cdd78a73eedc018079624af17dda81bc7579ef42081c4a267f2bad77c3699bb5cb998aa704419363051e5c306b30be49df14eadc499032e535e2615b387a4bf19ab9412da24d4ccda7d557da6f8d1c1c3aef4dec4058bb82ce73305fca7b96498a45f373c8c73f6057b9fd0947986f924560a17a549c9a7e76a884e74d03de6cebbfae7f5e37b8e32b23258c81bb9db0a86a7ea7367d3c101441f0add897b4a171829bf94c80587f585b6f9cc8eb7727340c25349699c756357177e30ce84b10ca62f12d06279ee01da0af14fbc98bd63e846e750b1460812e7b0b897e1c35f74f2e061b7889d12d2263694f47dffd493f26f37c2bf4d51f61bec174df96427ebc40ac3a5d319b60052e27d5ebcb3fb0f1f9adb21d6701964c468b59308f9d842f6025c4a9b8c5aa85844769f2c3ff4049896951cc01732c719c88aaf93cbcae38e3c004b9a80943f130f2f7a304b7a6035ddb5b6731e237f0cf5bf6c403a3d889443ad621039b4dc97d24ab631026ad80feb0f10489aabd63c7af40ad60da794a4ccae817e5118c34b692f6ea58d13b8f3d1ce12df29a04092be127a60f50ddca37943890f8a32025cf1bc84ca7a37ceccc6503c1edc24331d4154aa4ce31b740383da8771e05819146a30e8ba2aa22fe778b7a2ceca3790b19ca1bf34bb6cfc4d66bbe3afc5024b0fd8df5501fccdf681316ebd28fd17946d8e24e8d200149ff4160e731bd7a573b6f72c5e3b66ef7b5a99182e69c9e0ff5816dcd9d6ff390fd1e17362732b3780530cfd9831380ce825f4b0f18ad6247662fe331878f3438288b61dc200cb4ee742484a4915b4f896dc4d8037b009bf68deb87f36f91dcfc832e64da43ec18d0ca230e6a67bed1e3c28d60f9a2c53c7371d799a0ecbab5d2e18df918d58075b38dd541449501923101fc5cee94edbcb8b18df64aad61e0bcb80d90188e47a6a10488a111095df8a664b95250744c41d80960156e6a23daf115b1ae43295d3d1d2cb7b58c9b2970359f7e53b825429982ac5ff1a2916ab41244792af6dbf7522b2949e0bbfbd334399112b5d8e9a590be7a9ad1f929c0ea19978a47fad9209c9de45886f65e755602077f311

Flexible, dynamic layouts on demand

Patterns are not limited to specific pages and you can use them to add layouts and functionality that doesn’t already exist. Our Recent Articles extension, which allows you to display a list of the most recent articles from across your help center, is an example of this.

Most recent articles
View code
2d141f74a47b63f7d4bee425d94bf3d584af641b759d65894af05aa6652d517a279591e4d1b9609f5f08fd583aebf372106d8c5aacbd2bf1bb9115ee02af7f404c65ecc444b7ac22ce2c886b8e80dc7fe040fcd5b7c40e0cc86b7c3b3d8d5c4230355e5d8d79ba64102b380765b209ddc62723c98f06cf8589a18f554970f40c36293252ec0ff0a4f36dbb2a4152391867d4967fd3430fb642b16ab738647880a250da2ec40e735501e2f2fd0e3ad2f028881ade67349c6f931351735ad4ffd02228e3206dd752d210932cfa95d627f3d8ae0872c09bdc3c32a1db093e8413567214ff7be884a2f803120f8a7f006130ca76159a10d0ac60aa7d4e18340974e348ea4f2dab233af2755f89ef53c99207a3d05ba2e1997f2e00d2892d349a7d19feddda12e0064027a95cfd926b6672c0a6945d652fa3311af1e41bbf3cf69d73d81483607895c945c7a95e5bf64888f766f28b0bf80f90aeed688fe447e6b75c097c40f0c2265909230f84ffbc5a2897858c739c8e7390f69ac599d798c9cf2e388ce182466e36a3cf2a310bb5983bbe7e59419e25aa7d69cfed617143d9e13bf06470ef2257891f1ff44b306ab93cc6ea64f855dfd8cdcbdf6e1a52daaf339bfac9e17c49a5c2d828461f8a679467565601e524c1c681fdbc713078b20820269fda763252855f7dc9b943c4fe18f3337b1b9f29bd3312250cb9fb5171b310c92a6855eaec02dc7b668361c29d85913b9b404a4938885158b5a2489601ec5686e1a4e4e6a3041a4845adb338fb6b4da2133e2054948072b68fbe151765f0c5393016c83fa65a4cd92b8094785df7289faccb250a1aec6e8c542015b8abc2e1d776cd7088a3f7161d3a4cd82af63e268031670324f8368ae9608cde1a3632850519844d50cb07038a32392c18d4cf0ab43e437158b69538886238ad1b7f966262c08d4d90a7ac78c9f225334dcd5345d7eee2d5bff172f37caf16663c37f88f21295832f22cb353c856a5239858ebc82ceffeb1d2555d21768b0ad063b368a27131179b5e5534c77ad7b969fad5e65a2f40870dee9ce86bbe86fc9f5aafdf7e8b941ada743978e8dbfa8aa41820b11ed32e66676503459b5f26a90ed6293bc483d377b05b16672fd326bad9dbb84c2e76713da70afcd1f30f68b4ce599f35c470a69c67a9eb99be05fa6545260fbe5a01718f66284c34df4c68dc4b5d17649c5419964b119a31d4d3d96f7b876fa1912c6ca2ef12ac958218cf47ba0b52e428f78961b408783e549c5123400fb4b688e9f67917ebb4fae6f97bf25dda314b7c11fdada21b7807f3bc7ca880b5ce2a4591f9ebf2966e4b11d3a19fa2bd00836f984bda40060ff43fd15baf48ce58c278aeb6f5d280cacb788d8a32c59d581f728dba5d8737c205af565d63fa28cd4db3cf5f092cee3a0a7739b487b3fbf659c23dc26577fa32ce5facd1771d33811fd57c2d23da64a80b7d70bdd0dfe0a6d409e79bac1f8e3ed40f02e9147b8705a75d91de4c052efa8551bd97bac6b0651bb927e415900429dc3825d348e507136a3aae02f442bff6780c69ad4dd8ca2f358e1018b0eaa25f78b20e61227a20febe0761e65813e141ac55c01ba11bd6ea74f829d54c7fac217871935bec0973912a363710604fe4cfa5acc854356ee8a51ed28361cb31fadbfe228eaec15a3eabd1cb0ea6486f07553ba1953dc0bf18514834a5e4d9154cee0c64e425dc9e4a2425c2e49eee71b3389f574533ca4624a40799d0616ca8bb94616eed1c62b1ae5562508f7dfb597ce5fac33c8a113f697e8c7d25629ac1e4f9389ba13f9c7e95622f58e03aad12709702ec2ab36a657520b63d9ef3c9bb3ce6d13245b1449f93438a5d8815d47dd7292242a569b48a94c6641012715e172c8bba84fca0539dd26300fe8552663aab8ecc9741462b4e148dd4dfe69b17ac42adf5b56fd6d78c2e18329c436890913d4187de85b0fd7d91ee905d0814e3d0e733665892736554dc8569eafb3cd3c7d27b045c7939efe6ab492dcf5be4d9c806fc17f6c335bc47d106eb51d86ade8a5801d92a831b2e144515d3cde0007e4860bc7a94257f8c2662efbfc76df87732658e4d2995edcc5f64826d12c6caa0dc812b6dc35024367258b3e62664abf9a67a7478216230bfefd1c0168151b17ab92e0462c2afb9f230f435aa1cdbbdcfc5eb0bec6549d6a880cedbf5736125e5c594a9f90fb8e5fc6ea050428e4f175b4162908b3a6386035b0782adc380ddc4f9982f5c76bff30da9ca89f4a3c1612b717a6253062a72fb45600753ba6d89b16f6e32d255a04df0f11c2c82b15ed84cc8fcad18a96951704ba1d62cee9c090587d4b650792c963c3500bc7decdc73bec3a910adb8f2f3354331158d0a29c699908ef76b5d595c84acc9da122f7a85756bd1a735f3ff685c2778db0caefe734bdc403c743de105d4d3adf5b2827eadb02f0c801db9288790d681ace7416f33d7ee7e239e5a5624d3a62309532db456a9172e55064846bcd9414fbd1ce50302c542cb9d2387676cf4452b6650411cdf3deb06ca7277b1406da307d31fb19acda39e0679c15800c67d3339f99e1a0a3278abebb987a0436fab2fb6939563ba543ad6fd530ec5c10b6903933c0ee46182cc8b99918d50b704b54f69e9dc4de409632194128026915a17e7261e6044a32875278164e26beb8507feab757dc5c1712772205c1dfa6e6c248e1e8287dd188704c25562eaf2f0ec8ae631fa8481485ec9b55499e2049f523cb8323a7ede055c614339c292cce7ea63ef72108553ebcc2d79bc722cf59ffa8c6b8bf3e5a649c172d56f9d1f315f8c062247478499687f65dd4ae2a5eb7bdd2de4084d460ab314b8eec43eaa789097dad9eaa1c875c7c0f4dd2ac5dcd54bbcbf63ac200376f5ed98f0656cabd05731b7fe54c8bc6a23221cf81ae5d4ce68a7c3c57429a3e5a3c0aa3263b6421163d50ef8ce403623327b796a80c55f832eb933c5d8544477b54f40fa3da9893821278fd1e685486336d933591a1eac13d3eff8e1be0d3bc13bb3ea12bcaca92254b18aaa134c31b98a01a90bc96132a42565864a87eb31793cdc8e02af18323be1d65dbc22d450bfa09ceb8f0252c1419e7d85781ff6853ab50db91a8ec3d54b25f4b69bbf52bd6b8e04ad9c6c184aa98ec971c0d596122c8c31061ba4cd38410137a897192e44e348dbde47ac033e8a884f12cdf2e651aba4ed4b13b7459310a167ae1646bd96e36180a51ac43110a7afffe6d00095421afb85b9677d2004a396832fa2b4fced4267b6108e3d608e1be0c41ef15ab28b75cdf51f1c0d9ad7406cff8daac582f89a45a42f55552020679c766ccd970587409507394c2080f718d1c925641b898091cb0c90602ec5692c69071e20e3937cf0e2ac98fbd8f55f08a0d882248d01f1b4ff56c850e54197527351463ec844c31076c2cb606b355306071a4a8ac0c30ac45130a387552c13d251190b0a3548991afa80b7f7ef19d15b68c5d9cf694595433b76a17fd3a1d3626fefb8608ab02bc0e3ccf039774637444168cf24a346acdb69aec3e142f48dec270de2f0d322bdc96042fd34579a4734cbab825ae59977a68d6cf2cd17f9e65c8882f554a941fbfcb63de3f08a68c44d02c107947fb6acadcafa6a919a6f55e8c61a7cf068ef3b7dc8bd7f789d50ab7d58e3b837b7ed5f7fa9f394026849a8c0a452798d0aa9eac973c8206394ecea396cde231a0c1c29fe40679c20399b47410b358bed1e1eaa79ec39c3f9b300eff5f0360fcfccc775e5db0bf4b5739d50e14801525fb1fc3200f022c7ecbbd59a0f148ea792e2cd457a968d47efdbaf61b27c3d92b4d784b0939fdc6de13d378940f36c0628d064ef9aae7218fe44987c99b0e5fd29db5299d8197dacc15fd25e21b0812b040e3bb4067e6e78ebe7ad5563be5582ed818c6cefc96bd07b1b9d93e65d13fc9f4109a511b0064e1237181264a10d7f935d314131273d5e3adb1534b65131ce73db3201d93999e80f34a6908f1997c0c3ef1fbdb7802c8d7449191443375f4679410b9bef1cd0de93dff740dbfae97bda1c85ed354cd9e33981b057aadcbc379b7af54c96124b59f6a268062eaeeb96a56141ed89f23e8629365f7188e07f04c6a248b88a2c47647efbd8e46af34b5a136969336aadbcea97b1a3d26b6d6beb63bc902165644f90acafb937bed7ee1cc1569bc8c4c7b4e720c929a910f6c5ee1ba7e3f1c23a11b9863b6479403de00975391d671b74145452ea3678dce0e92f22a66bda1285f8439cf3cb829971fd246b871981e70b5f6c181770095f80e9b20d517ec4afddc3b5c98e67700caf4e9b41ded1d1d3ef1105f80b404cf5c13505391afddaabdf5fb3dc5669a75b2c8a46ca5f3f57fd98b0f7da901eaebd32b7071106d1c4e79727fadc534995103ebdc8d2e685889a33bc91b583f614099f00b36170d97e9a26db7118f3e53cb27f4d069dacf0ac4479944f719f030786e4354ffdb28415f2647c363459d96eee678e244e9678d31521b154dbec5f1f30f8eae9498410371506be75abd03307a9006f22d96e731925f69843dc50a8118c1446179c910d06c2ff275fc451f4a1baa57e4e489f0a8f8405fe9caa375a0511b2142221e11c0701239a94a14de0a353bd6db5cb33b3de2a4e9a052d131dc2ded78c6b6ab963fdbdc8ff9907d724255f099452add53d0afac35641c06b014149eaa398b689d0434a3b95a240a46add1c921e776bf04be16af6bfd2f3c42df7ef845b4302a920a5b65ea887b8d35257111696d450cb4c981be9679cc172cb2854cce6d5ab2c32dbe64c60a7b419d6b1edd2c99f179677c1a24ce198467a4c5038a401efc98a0c8eb77244320f650554595fccef7ac1af04b64a64ecd43d16cc55d7250a5b1352f27edfae26bb6c08762b40c944a6caba388920e10962854541ec0015ad831adf3d09c01a58491c37a6f101a47fe6e2e96670b952ef6ae4d506ba3f103f80c3bc5c654c591642d5df716674ecdaf90beaec46e24e284d88943f77fabd8091c371529490002a79803116da3275dc924f6e89057cbf0a05482057132abb387c40d935855919723d0e330218a29ae9f78cb3842952725141174a09f0df639b53519ab5ca6f78acee977a964bb94b47b7491d694f42c38a334216f2c3c3bad37d375d9a7f99ece8ce392b8891546d0cd2b6f85c8c7b5475adc1294b40b97e06a2528de532977303e1202bfdab3ec54cf78b8c1e88c2ed7e5e7a2703b4a0db273a0524a3d712d61f79850e8b1ac7e472505ff1152601222a500d817d41b15826d2913ceb3b5955e5f44fb2005089dbfac33b122f59d1ccf218aa7d3fca1b86e4010547e250e42b05861760ec1d0b11e956ca8d412eec4f0229a1844f2681e849f5205356202dae7abeecc2272602eee8726c1110626e90274ecdb322ac692af42a9dc502db9952c0fe267c33ebb1d52946cdea59610eba491896d7527e35f2abe1b59a48d5e557fb0840b62e2f2eb183c0215f0d4c344da6d10783583b9eb268cf76388d6ff49258573dd4828a8d8cd2f28e6b91256ec9879ea23cad65a751fd11b200b52919ffa2745a69c01c8a6fc678cc655385b5147318b08456bdf9873741b7f6f8527d29ddfbd0414a46975110051b65f8c815a239ddc021c12c73d7b725e4cbcb1615891130067dcc8f68a87b55d92a08d975a85b6bae541739ed9b2b41fbb5e569b09f68d264517ece63e69400d5deb961b8b83a3c355bab10a2d5111296d3aeea374a541b8e583f2995cf90e628a9345c0a92037be0521d693a967d0fbd58f1181fb9658d72d3aa825dd689be3b48a72cc0ba7d366cdb7804f488885396227401cc72df3753ff0c976f042b1353748fa73c5a94fed7eb9f7d89675d9afebf9502771871265e75e790770c7abfc411fd1b21a44fd5dce7cec3519f6a221c367e5aed6e3ab6ec381d9dee2c2e7199d59b50bb994e4d2db5779072d6bc4c626b423e86599cff698c55d7b6cbd4c135050e87ade18c0934bd083afdc986fe03d26daa4ce19a246d59dd111b10b1157712c1866354e928fb4e5a6fd516678dd3f7dae8232e1a397ac6256287a8bcab06cff434ce778f570518cf35f30670b6b8b55d57439a9b1c7721b4a549680a342bcb1f2ae86dc5cc24e260cf0c7241d6fc1fb12b62101be3d2e54b2ed633503d1f16bad6e1f8cf11d3b7fb1da714a3c287c26627026b0a51ebf53cc6acb3350d653c938fa1a684b5677832b06bb3f29b9c40b70f4b0e11c2ef0e339870198f437e13f5fadc2f87906853ac32f45193b96e77cbae259bca84bc83867abb5189615f5fff7f211fdc61ffdec31dc02d91e6dce0d3aebdfe4b871bc0c1de764e5383effc9c1b73ff06d74d6abd8a527b7f4ecf4be004a81ea0173f47b338fb9add62630c8f6ab7ea87d51a19a574b6c5f7c93a881ef7912dc6047e04f6c1271e5da8a96a8c2213565a15d043129b12143defedba8bbf62361843c867c2d19a022bc3855208571e308cb4492f8d3d0f1f44fa4e625ecca7eefd9f6c19cab50704d66094b7cf611d

Our themes also come with many configurable elements, like content blocks and table of contents elements, which you can customize using patterns. The look-and-feel and even functionality of these elements can be completed changed by copying a pattern from our library into the theme as described on each pattern’s page.

Because patterns must be copied and pasted into your theme, you must have access to underlying templates. To get complete access to the theme source code you can purchase:

  1. The Developer license through the Zendesk Theme Marketplace; or

  2. A single theme or the Complete Package through our website.

Questions or feedback about this article? Let us know