1. Home
  2. Book Pages & Links
  3. Using Variables to Customize Your Pages

Using Variables to Customize Your Pages

Use variables to customize your download pages, giveaway pages, and Certified Mail campaigns! With variables, the text on your page can address a reader by name, countdown the number of remaining copies, and more.

Here are a few examples:

  • Hi, Ashlyn! I hope you love the book!
  • Grab yours today! Only 3 more copies left!
  • This book is only free for the next 38 minutes!
  • Only 1 more day, and this offer is gone!

How did we do that? Like this:

  • Hi, {{first_name}}! I hope you love the book!
  • Grab yours today! Only {{copies_more_remaining}} left!
  • This book is only free for the next {{time_remaining}}!
  • Only {{time_more_remaining}}, and this offer is gone!

What You Can Do With Variables

You can use variables on any BookFunnel page or Certified Mail campaign, and even use them to send custom data to your mailing list if you have Integration on your account. Use a variable to:

  • Host a “Flash Giveaway” for 10 copies of your book and countdown the number of remaining copies
  • Countdown the days, and then hours, and finally minutes left to download a book on a download page of Certified Mail page
  • Thank your new subscriber by name on the “thank you page” of your giveaway
  • Send the book title as a custom field to your mailing list service

How To Use a Variable

Add double curly brackets like this {{variable}} around the variable you want to use. Here are some examples:

  • Thank you for subscribing, {{first_name}}! You’re a gem. You have {{time_more_remaining}} to download your reserved copy of my book.
  • Hurry! Hurry! Only {{copies_remaining}} left. Grab your copy before its gone!
  • There are only {{limit}} free copies of Alice available and {{claimed}} have been claimed. Hurry before they are all gone!
  • {{num_downloaded}} copies have already been downloaded! Get yours now.

Supported Variables

Some variables can only be used on Giveaway pages or in Certified Mail, because we do not collect any reader data on a regular download page. For example, you can’t include {{first_name}} on a regular download page, because we don’t know the reader’s first name. 🙂

Here is the full list of all of the variables we support:

 

Variable Value
{{author}} Contains the author’s name.
Valid In: All Pages, Certified Mail, Integration Fields
{{author_email}} Contains the author’s email address.
Valid In: All Pages, Certified Mail, Integration Fields
{{author_url}} Contains the author’s website.
Valid In: All Pages, Certified Mail, Integration Fields
{{copies_more_remaining}} Contains the number of copies still available in the format “X more copies” (download limit required).
Example: 16 more copies or 1 more copy
Valid In: All Pages
{{copies_remaining}} Contains the number of copies still available (requires a download limit) in the format “X copies”.
Example: 5 copies or 1 copy
Valid In: All Pages
{{date}} Contains the date the reader signed up to receive the book in the format Year-Month-Day.
Valid In: Giveaway Pages, Certified Mail, Integration Fields
{{date_expires}} Contains the date the page link will expire in the format Year-Month-Day (expiration date required).
Valid In: All Pages, Certified Mail, Integration Fields
{{date_time}} Contains the date and time the reader signed up to receive the book in the format Year-Month-Day and time GMT.
Example: 2017-11-30 09:30 GMT
Valid In: Giveaway Pages, Integration Fields
{{email}} Contains the reader’s email address.
Valid In: Giveaway Pages, Certified Mail, Integration Fields
{{expires}} Contains the day the link will expire in the format Month-Day (expiration date required).
Example: April 21st or May 3rd
Valid In: All Pages, Certified Mail
{{first_name}} Contains the reader’s first name (first name must be required on the Giveaway Page).
Valid In: Giveaway Pages, Certified Mail, Integration Fields
{{last_name}} Contains the reader’s last name (last name must be required on the Giveaway page).
Valid In: Giveaway Pages, Integration Fields
{{limit}} Contains the total download limit set for the page (download limit required).
Valid In: All Pages
{{name}} Contains both the reader’s first name and last name (both first and last name must be required on the Giveaway Page).
Example: Jane Smith
Valid In: Giveaway Pages, Integration Fields
{{num_claimed}} Contains the number of readers that have claimed the book.
Valid In: Giveaway Pages
{{num_downloaded}} Contains the number of times the book has been downloaded.
Valid In: All Pages
{{num_remaining}} Contains the number of remaining copies available (download limit required).
Valid In: All Pages
{{page_id}} Contains the unique ID of the download page or giveaway page.
Example: 7kh10vq0ec
Valid In: All Pages, Integration Fields
{{page_link}} Contains the download page link or private link the reader received.
Example: https://dl.bookfunnel.com/7kh10vq0ec
Valid In: All Pages, Integration Fields
{{time}} Contains the exact time a reader signed up to receive the book GMT.
Example: 09:30 GMT
Valid In: Giveaway Pages, Integration Fields
{{time_more_remaining}} Contains a countdown of the remaining time in the format “X more days/hours/minutes” (expiration date required).
Example: 1 more day or 37 more minutes
Valid In: All Pages, Certified Mail
{{time_remaining}} Contains a countdown of the remaining time in the format “X days/hours/minutes” (expiration date required).
Example: 12 Days or 1 hour
Valid In: All Pages, Certified Mail
{{title}} Contains the book title.
Valid In: All Pages, Certified Mail

Variables are not (yet) supported on BookFunnel Bundles pages.

FAQ

What are variables and why are they so confusing?

Variables are a power feature and not necessarily a tool you want to use on every page (or at all). You can experiment with your pages to craft exactly the reader experience you want. Play with the variables we support and have fun! If these {{brackets}} are intimidating or not something you want to mess with, that’s ok too.

What happens if I use a variable where it isn't supported? Example: Using {{first_name}} on a download page.

The variable will not be displayed.

Can I use a variable in the book description or tagline?

Some variables can be used in book descriptions, but be cautious. Variables that pertain to the reader or number of downloads are not a good idea. Any text, including variables, that you include in the book description or tagline will be carried forward to every page you create for that book.

How can I check that the countdown grammar is correct? I don't ever want a reader to see You have one hours left.

We cringe when we see those errors too, so we built the variables to be handy and grammatically correct. For example, use {{time_more_remaining}} and the countdown will display 2 more days and then 1 more day. We also created {{copies_remaining}} and {{copies_more_remaining}} so that copy and copies would always be correct.

Was this article helpful?