Blog

ColdBox Free Tip 4 - Using a Struct for Query Strings

Victor Campos September 09, 2025

Spread the word

Victor Campos

September 09, 2025

Spread the word


Share your thoughts

102 ColdBox Tips and Ticks by Luis Majano

How to make your code easier to read and manage with ColdBox?

ColdBox gives you powerful ways to build cleaner, more maintainable code, especially when dealing with query strings. In this tip, we’ll explore how to pass a struct into the buildLink() method, making your code easier to read and manage.

Using a Struct for Query Strings

Instead of manually crafting query strings like this:

<a href="users.editor?id=3&format=plain">My Link</a>

You can let ColdBox do the work for you! By passing a struct to the queryString argument of the buildLink() method, ColdBox will automatically convert it into a properly formatted query string. It makes your code more readable and easier to maintain.

Here’s an example:

<a href="#event.buildLink( 'users.editor', { id:3, format:'plain' } )">
My Link</a>

ColdBox will flatten the struct into the query string ?id=3&format=plain for you. It’s cleaner, easier to read, and less error-prone than manually concatenating strings.

Why Use a Struct for Query Strings?

  • Cleaner code: Using structs keeps your links more organized and reduces the clutter of inline query strings.
  • Easier maintenance: You can quickly add or remove parameters from the struct without having to worry about formatting the query string manually.
  • Flexibility: ColdBox handles the conversion for you, so you can focus on writing code instead of worrying about URL structure.

Give it a try in your next project, and see how much cleaner your code can be! Stay tuned for more tips and tricks to boost your ColdBox development.

Learn More ColdBox Tips and Tricks

Stay tuned for more ColdBox tips in our ongoing series. if you want to learn more than 10 free tips and tricks make sure to get your “ColdBox 102 tips and tricks book” We have a variety of formats you can choose from.

Getyour Copy

Join the Ortus Community

Be part of the movement shaping the future of web development. Stay connected and receive the latest updates on**, product launches, tool updates, promo services and much more.**

Subscribe to our newsletter for exclusive content.

Follow Us on Social media and don’t miss any news and updates:

Add Your Comment

Recent Entries

Speaker Featuring - Round 1

Speaker Featuring - Round 1

Every conference is more than the talks we see on stage it’s also the story of the people who make it possible.

With the first round of Into the Box 2026 sessions and workshops now live, we’re excited to introduce some of the speakers who will be joining us this year. These community members, practitioners, and Ortus team experts bring decades of real-world experience across CFML, BoxLang, JVM modernization, testing, AI, and cloud-native development.

Victor Campos
Victor Campos
January 26, 2026
First Round of the Into the Box 2026 Agenda Is Live

First Round of the Into the Box 2026 Agenda Is Live

Into the Box 2026 marks an important moment for the CFML and BoxLang community not just because of what’s on the agenda, but because of what it represents: 20 years of Ortus Solutions helping teams move forward, modernize, and build with confidence.

Victor Campos
Victor Campos
January 21, 2026
BoxLang AI v2: Enterprise AI Development Without the Complexity

BoxLang AI v2: Enterprise AI Development Without the Complexity

One Year. 100+ Features. Unlimited Possibilities.

Just one year ago, in March 2024, we launched BoxLang AI 1.0. Today, we're thrilled to announce BoxLang AI v2—a massive leap forward that positions BoxLang as the most powerful and versatile AI framework on the JVM.

Luis Majano
Luis Majano
January 19, 2026