Frequently Asked Questions

How do ShowTextQRs work?
  1. ShowTextQR uses a proprietary method of creating URLs that show text when encoded into QR codes. For example, given the URL HTTPS://EXAMPLE.COM and the word "MENU", we create a new URL HTTPS://EXAMPLE.COM/#CDHQCAPHXOVANMDAWSBG.FC:MYBHMYBHMYIETJVZWCUGG4$/5ADXIM9JIZ9G9T1F/F-7UOMGYI59HLDM+$7UK-433+-.FRMXMC-+AALLERUUDVPDADAWAPTCVMGFZINA
  2. The seemingly random characters starting with '#' after the original URL cause the word 'MENU' to appear in the QR code we create. When the URL is encoded into the QR code, the word appears.The word 'MENU'
  3. You use the ShowTextQR in your ad, poster, flyer, etc., just as you would a plain QR code.
  4. When someone scans the QR with their smartphone, the QR is decoded into the URL.
  5. When they click the URL everything after the '#' is ignored and they visit your site at the page you specified.
  6. Note that if you take a ShowTextQR URL and run it through a QR-generating tool, you might not get the QR code you expect. We control the QR creation process through proprietary methods that 'plain' QR tools don't use. ShowTextQR QR codes are valid and in full compliance with international standard ISO/IEC 18004.
Is there limit on the length of the URLs?

Yes. 51 characters for one-line (37 cells) QR codes, and 67 characters for two-line (85 cells). URLs that are too long would run into the part of the QR code used by the text you have entered. The resulting ShowTextQR would not correctly show the text you want. You can create a shorter URL on your own site, or get one from a shortening service. See the next question for details.

Note: These length limits are typical - it is possible the QR generation process may fail for some combinations of URL and text. If that happens, we issue a warning message and don't produce a QR code.

Can I use a shortened URL? How do I do that?

Yes. There are two situations where you will need to do this, and other cases where you may prefer to.

The first case where you need to use a shortened URL is when your web page doesn't work with an uppercase URL. For example, the Wikipedia page: https://en.wikipedia.org/wiki/Oak doesn't work in uppercase: HTTPS://EN.WIKIPEDIA.ORG/WIKI/OAK. Most websites are set up to work with either uppercase or lowercase URLs, but not all.

The second case where you need to use a shortened URL is when the URL of your page is too long, or includes a '?' character. Facebook and YouTube are examples of these.

You may prefer a shortened URL for other reasons. A shortened URL may allow you to come back later and change the page that the shortened URL refers to. If your site changes, or you want the ShowTextQR code to send visitors to a different page, this is very handy. Also it may be helpful to gather traffic stats for the shortened URL, so you know how many visitors the ShowTextQR QR code is sending.

You can create a shorter URL on your own site. This is preferable, because it is under your control, and doesn't require any ongoing maintenance or fees. Or you could get one from a shortening service, which might not be free.

Create a Shorter URL on Your Own Site

Talk to your web developer or site administrator about creating a short URL with a redirect or alias to the long URL. It's easy.

Using a URL Shortening Service

This is also easy. You must use a URL shortening service that allows you to customize the shortened URL with all UPPERCASE letters. Bit.ly and Tinyurl.com are widely used shortening services. There are many others. Beware of costs, especially recurring fees.

On the shortening site, enter the original URL of your page. (Not one that you changed to uppercase.) Also enter a customized URL that is still pretty short and uses UPPERCASE. You can enter a customized shortened URL that is meaningful (like 'DROUGHT' for the NOAA example above). Then click the 'shorten' button.

Copy the shortened version into the 'Destination URL' field in the 'Make Your Own' form.

Now you are good to go. Finish the form and get your ShowTextQR.

Why Did I Get a Note About My Link?

Before we make your ShowTextQR, we visit your link once to make sure it works. If we don't get a plain "OK" back, we show a short note instead of making the code, so you don't end up with a code that goes nowhere.

Most of the time, the note just means your link forwards somewhere else -- and that's usually fine.

What the note means
  • Your link forwards to another address (HTTP 301, 302, and similar). This is by far the most common. Short links (Bitly, TinyURL), QR-code and link-tracking services, and many websites send visitors on to the final page. We don't follow the forwarding, so we just let you know. If the link ends up on the page you want, go ahead. (If your link starts with http:// and forwards to https://, you can use the https:// version directly to skip the extra step.)
  • Your link doesn't go to the same place in uppercase. ShowTextQR codes store links in UPPERCASE, so we check the uppercase version. Some websites -- short-link services especially -- treat uppercase as a different link (for example, ending in /bcndsW versus /BCNDSW). Use a link that works in uppercase; see Why must the URL be UPPERCASE?
  • Page not found (HTTP 404). Check the link for typos. Or the page may not be published yet -- that's fine if you're making the code ahead of time, as long as the page is live before people start scanning.
  • Website can't be reached (shown as 0). The address may be mistyped, or the site isn't live yet.
  • Anything else (such as HTTP 500). The website gave an unexpected answer -- it may be having a temporary problem.

Whatever the note says, open the link yourself -- on your phone is best -- and try it in UPPERCASE too, since that's how ShowTextQR codes store it (see why). If it lands where you want, check "My link redirects or isn't live yet" just below the Destination URL field and click Generate again.

How long can my message be?

Whatever fits. A simulated QR code showing your message is displayed as you type in the form. Some characters are wider than others, so we can't give a specific number.

Can you show numbers?

Yes. Any combination of ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789$%*+-.:=()'"!,;? can be used. Lowercase letters are not allowed.

Why must the URL be UPPERCASE?

This is due to the technical process used to build ShowTextQR QR codes. It's a long story. Note: It is possible that your website is configured to treat uppercase URLs differently. For example, the URL HTTP://EXAMPLE.COM/some_page might work but HTTP://EXAMPLE.COM/SOME_PAGE would not work. To prevent problems, verify that the uppercase URL works before you create your ShowTextQR with it. If this is a problem, use an alias or redirect on your own site, or use a URL shortening service to generate an uppercase URL. See Can I use a URL-shortening service? for details.

Why can't I use a "?" in the URL?

It's a long, technical story. Your URL can't be encoded into a QR code with a "?". You can use the letters A-Z, the digits 0-9, a space, and the symbols ($ % * + - . / :)

If you need a "?' in your URL, use an alias or redirect on your own site, or a URL-shortening service, to get a clean short link with no "?" in it. See Can I use a URL-shortening service? for details.

Are there any ongoing costs for my ShowTextQR QR code?

No. There are no additional charges after the purchase. Your ShowTextQR QR code is all yours. We do not control or manage it. Your ShowTextQR QR code points to your page, not ours.

How do I know my ShowTextQR really works?

You can test your ShowTextQR easily with your smartphone camera or QR scanner app. Scan your ShowTextQR, and the app will display the web page URL you entered when you created the ShowTextQR (along with a lot of random-looking text starting with '#'). Click the 'Open Browser' button and you will be taken to the page.

What error correction level do ShowTextQR codes use?

Level L ("Low"), the lowest of the four standard levels (L, M, Q, and H). Level L leaves the most room for data, which ShowTextQR needs to fit both your URL and the pattern that forms your words.

Part of the error-correction capacity is also used to help shape the letters. That leaves less margin than a plain QR code for damage, dirt, glare, or covering part of the code. To keep your ShowTextQR easy to scan:

Be Sure to Test the Result with your smartphone before printing in quantity.

How do I track the response to my ShowTextQR code?

Here are some ways to track visits to your site triggered by ShowTextQR QR codes:

Can I change the page the visitor sees?

Your ShowTextQR will always decode to the same URL, but there are some ways to change what page the visitor sees. For example:

Of course, you can always change your page content however you want.

Tell me more about the zip file.

Zip file usage notes

Downloading: Dealing with zip files on mobile devices can be painful. It will be easier to download and use the zip file on a desktop device or laptop. On iPads or iPhones, we suggest using the Safari browser.

Note: You may be able to view the contents of the zip file without actually extracting them. But to do anything useful, you will need to extract them from the zip file. Your system knows how to do this.

Extract the files before opening the HTML file. The HTML file expects to be opened in the same directory as the other files.

Contents of the zip file

We provide multiple formats to give you flexibility in using your ShowTextQR. The PDF version can be used in any printed material. The SVG version can be embedded in a web page. PDFs and SVGs can be scaled up or down. Be careful not to lose sharpness if you downscale.

PNG format sizes

We provide several ready-made sizes of the PNG image (plus a full-size PDF and a scalable SVG) so you don't have to resize anything yourself. Resizing a QR code image -- even slightly -- can blur the crisp edges between black and white just enough to make it harder for a smartphone to scan. Pick whichever size is closest to how you're using it: something small for a website or email, something larger for print.

If you need an exact size -- for a banner, a storefront sign, or professional printing -- skip the PNGs and use the SVG or PDF versions instead. Unlike the PNGs, they scale to any size with no loss of quality.

How do I use the images in a print ad?

Just include it as you would any other image, photo, logo, etc. You (or your graphic designer) can select or adapt the best image version for your purposes.

For magazine ads, try to avoid placing the ShowTextQR image close to the binding. The curve of the page there can make the QR code harder to scan, and they also are less noticeable than when they are on the outer portion of the page.

If you resize one of the images, make sure it is big enough for good readability by humans and good scannability by smartphones. This depends on print quality and how close the phone is to the QR code.

Using your smartphone, test the ShowTextQR in your finished ad before publishing it.

Altering the Image

We provide images formatted for maximum readability by smartphone cameras. Any alteration is likely to make it harder for cameras to correctly read the URL encoded in the image. Be Sure to Test the Result. Also, make backups of any files before making alterations.

How can I change the color?

The default is black text. We include files with red text for convenience. The .svg file in the zip file is set up for easy editing to change the color to anything you want. Complete instructions are in the README.txt file.

Be Sure to Test the Result - It is possible to choose color combinations that will make it hard for smartphones to read properly. Check your changed ShowTextQR QR code with your smartphone before using it

Can I edit the SVG file myself with Inkscape or another tool?

Yes -- the SVG in your zip is a standard, editable vector file, and tools like Inkscape, Illustrator, or Figma can open and change it.

Two things to know before you do. First, it takes some vector-editing skill to do well -- it's not a quick point-and-click edit. Second, changes like recoloring or reshaping parts of the pattern can make the code harder, or impossible, for a phone to scan.

If you edit the file, test the result with your smartphone camera before using it -- same as we recommend for any change to your ShowTextQR.

Can I crop the border?

Yes. Be Sure to Test the Result. Cropping can affect the ability to read the ShowTextQR when the camera is not precisely aligned with the image.