# Landing pages

URL: https://qrdx.dev/docs/landing-pages
Source: https://github.com/qrdxinc/qrdx/blob/main/apps/docs/content/docs/landing-pages.mdx

Build a mobile page for a QR code from blocks, with no website needed. Link lists, business pages, vCard Plus, menus, product pages and 28 page types in all.

A hosted landing page is a mobile page that QRdx serves for you at `https://qrdx.dev/p/<slug>` (or on your [custom domain](https://qrdx.dev/docs/custom-domains)). Every page comes with a [dynamic QR code](https://qrdx.dev/docs/dynamic-qr-codes), so you can keep editing the page after the code is printed and see every scan. Use one when the code has nothing to point at yet, or when a phone-sized page beats your website: a menu, a contact card, a link list, an event, a product's details.

**Plans**

Free includes 3 hosted pages with a "Made with QRdx" footer. Pro removes the footer and the limit; Business adds white-label pages and custom CSS. Each page also uses one of your plan's dynamic codes. See [Plans and limits](https://qrdx.dev/docs/plans-and-limits).

In a hurry? The short task pages: [Create a mobile page](https://qrdx.dev/docs/help/pages-and-forms/create-a-page) and [Change what a printed code opens](https://qrdx.dev/docs/help/dynamic-codes/change-the-type).

## How it works [#how-it-works]

A page is a stack of blocks: a header, links, a contact card, a menu, a form. You arrange them in the editor and publish; QRdx renders the page on its servers, so it loads fast on phones and needs no site of your own. The code's short link opens the page, and everything from [code controls](https://qrdx.dev/docs/code-controls) applies to it: a password, a schedule, a scan limit.

## Create a page [#create-a-page]

1. Open **Pages & forms** in the sidebar and click **New page**, or click **New code** on the Codes list and pick a page type instead of **Website link**.
2. Pick one of the 28 [page types](#page-types) and a template from its gallery.
3. Click **Create page**. The editor opens with the template's blocks, and the page's QR code is ready to download.

![The page template picker: cards for menu, event, business card, coupon, feedback and other page types.](https://qrdx.dev/docs-static/shots/page-templates.light.webp)

Already printed a code that opens a website? Open it and click **Change type** to turn it into a page with the same short link.

Templates start with sample names, prices, numbers and photos so you can see how the page fits together. Until you first publish, the editor reminds you to replace them with your own.

## Page types [#page-types]

Every page type is a starting point: any block can be added to any page, and a page made from one type can look like another.

| Page type | Made for | Starts with |
| --- | --- | --- |
| **Link list** | Link in bio, creators, podcasts | Profile header, links, social icons |
| **Social media** | Every profile behind one code | Profile header, one row per network with your handle |
| **Business** | Shops, salons, offices | Hours, address and map, contact, a call to action |
| **Location** | Shops, venues, meeting points ([location page](https://qrdx.dev/qr-code-generator/location)) | Address with a map, Google Maps, Apple Maps and Waze buttons, hours, notes |
| **vCard Plus** | [Digital business cards](https://qrdx.dev/qr-code-generator/business-card) | Contact card with **Save contact** |
| **Resume / CV** | Printed CVs, portfolios, job fairs ([resume](https://qrdx.dev/qr-code-generator/resume)) | Photo and headline, experience and education, skills, links, the CV to download |
| **Menu** | Cafés, restaurants, bars | Menu with dietary tags and allergens ([more](https://qrdx.dev/docs/forms-and-pages#menu)) |
| **Guest Wi-Fi page** | Cafés, rentals, offices ([guest Wi-Fi](https://qrdx.dev/qr-code-generator/guest-wifi)) | Network name and password to copy, steps to join on iPhone and Android, house rules |
| **Coupon** | Discounts and freebies | Coupon with a code, a barcode or a redeem button ([more](https://qrdx.dev/docs/forms-and-pages#coupon)) |
| **Event** | Parties, conferences, webinars, weddings | Event with add-to-calendar ([more](https://qrdx.dev/docs/forms-and-pages#event)) |
| **Invitation** | Weddings, birthdays, dinners ([invitation](https://qrdx.dev/qr-code-generator/invitation)) | Event with add-to-calendar, directions, the day's schedule, dress code, an RSVP form |
| **App download** | One code for every app store | App download ([more](https://qrdx.dev/docs/forms-and-pages#app-download)) |
| **Feedback & forms** | Reviews, NPS surveys, sign-ups | Form, and review links on the feedback template ([more](https://qrdx.dev/docs/forms-and-pages#forms)) |
| **Contact form** | Enquiries, quotes, trade show leads ([contact form](https://qrdx.dev/qr-code-generator/contact-form)) | A form with name, email, phone and a message, or the questions you choose |
| **Product** | Packaging, labels, hang tags | Ingredients, allergens, nutrition, certifications, care, GS1 Digital Link ([more](https://qrdx.dev/docs/product-pages)) |
| **Appointments** | Salons, clinics, tutors | Services and prices, a booking request form, hours |
| **Payments & tips** | Tip jars, donations, invoices | Payment links and bank details to copy |
| **Property listing** | Homes for sale or rent, open houses | Price and facts, photos, agent, a viewing request or sign-in form |
| **Pet ID tag** | Collar tags, lost-pet posters | Call button, the pet's details, a "found it" form |
| **Medical ID** | Tags, wristbands, allergy cards | Emergency contact, conditions, allergies, medication |
| **Lost & found tag** | Luggage, laptops, keys, equipment ([lost and found](https://qrdx.dev/qr-code-generator/lost-and-found)) | Call and message buttons, a reward note, a "found it" form |
| **PDF** | Brochures, manuals, document libraries ([PDF QR code](https://qrdx.dev/qr-code-generator/pdf)) | A PDF to read or download, or several files |
| **Images** | Galleries and portfolios | Photo gallery |
| **MP3 / Audio** | Music, podcasts, voice messages | Audio player |
| **Video** | Product videos, clips | Video |
| **Playlist** | Mixes, audio tours, audiobooks | Several tracks that play in a row |
| **Message** | Gift notes, thank-you cards, notices ([message](https://qrdx.dev/qr-code-generator/message)) | A heading, a few lines, an optional photo and one button |
| **Custom page** | Anything else | A blank page or an announcement |

**Appointments** sends booking requests to the page's [responses](https://qrdx.dev/docs/forms-and-pages#responses) and notifications, and can link to your booking tool. It doesn't show a live calendar of free times: you confirm each request yourself.

**Payments & tips** never takes a payment. Each button opens the payment app's own page (PayPal, Venmo, Cash App, Revolut, Wise), and bank details, UPI IDs and wallet addresses have copy buttons.

**Pet ID tag**, **Medical ID** and **Lost & found tag** pages can be read by anyone who scans the code. Add only what helps someone who finds your pet or your things, or helps you in an emergency.

**Guest Wi-Fi page** shows the password to everyone who opens it, as a Wi-Fi QR code lets everyone who scans it join. A web page can't join a network for the visitor: guests copy the password and follow the steps. **Resume / CV** offers your CV as a file in a **Downloads** block: upload the PDF or link to one.

## Edit and publish [#edit-and-publish]

The editor has three tabs and a live phone preview. Tap a block in the preview to jump to its settings.

- **Blocks**: add blocks with **Add block**, reorder them by dragging (or with the arrow buttons), hide a block without deleting it, duplicate or remove it. Each block has its own form; problems (for example a link without `https://`) are flagged on the block and must be fixed before publishing.
- **Design**: use the colors of one of your [saved QR themes](https://qrdx.dev/dashboard?to=themes) so the page matches the printed code, pick a preset palette or set each color yourself. Choose a font, corner radius, a solid, gradient or image background and an optional logo. **Match colors** derives readable text and card colors from your background and accent, and a warning appears when text contrast is low.
- **Settings**: the share preview description and image, **Show in search engines** (off by default), and **Custom CSS** on Business.

![The page editor for a feedback page: the Blocks tab on the left with the header and form blocks, and a phone-sized live preview of the page on the right.](https://qrdx.dev/docs-static/shots/page-editor.light.webp)

Click **Publish** (or press <kbd>⌘</kbd>/<kbd>Ctrl</kbd> + <kbd>S</kbd>) to put your changes live. Nothing changes for visitors until you publish; unpublished edits are kept in your browser so you can restore them after closing the tab. Each publish is stored as a version. If a teammate publishes the same page while you are editing, QRdx asks you to reload instead of overwriting their changes.

## Blocks [#blocks]

| Block | What it shows |
| --- | --- |
| Profile header | Photo or logo, name, bio and an optional cover image |
| Text | A heading and a paragraph (line breaks are kept) |
| Button | One call to action: a web link, email address or phone number |
| Link list | A stack of link buttons, with site icons for Instagram, YouTube, WhatsApp and more |
| Social icons | Profiles as round icons, buttons, or a list with each handle |
| App download | App Store, Google Play and a website, the visitor's own store first ([more](https://qrdx.dev/docs/forms-and-pages#app-download)) |
| Image | A photo or banner, optionally linked |
| Video | A YouTube, Vimeo or Loom video. It loads from the video site only after the visitor taps play |
| PDF, Gallery, Audio, Video file, Downloads | Files you upload or link to ([more](https://qrdx.dev/docs/files)) |
| Contact card | Name, job title, phones, emails, website, address, quick actions (call, WhatsApp, email, website, directions), **Save contact** and **Share** |
| Address & map | Your address with Google Maps and Apple Maps directions, an optional Waze button and an optional embedded map |
| Opening hours | Hours per day (split shifts and past-midnight hours included) with an **Open now** badge that follows the time zone you set on the block |
| Wi-Fi | Network name and password with copy buttons, and optionally the security type and steps to join on iPhone and Android ([more](https://qrdx.dev/docs/forms-and-pages#menu)) |
| Details | Labels and values as a list or a grid of tiles (bedrooms, breed, blood type, net weight) |
| Timeline | Entries in order, each with when, a title, where and a note (jobs and schools on a CV, the schedule of a wedding day) |
| Event | Date, venue, organizer and add-to-calendar ([more](https://qrdx.dev/docs/forms-and-pages#event)) |
| Form, Review links | Questions with a response inbox, and review buttons ([more](https://qrdx.dev/docs/forms-and-pages#forms)) |
| Menu, Coupon | Sections and items with prices, and a coupon with a barcode ([more](https://qrdx.dev/docs/forms-and-pages)) |
| Product details | Certifications, ingredients, allergens, a nutrition table, sections that open on tap, and the GTIN ([more](https://qrdx.dev/docs/product-pages)) |
| Payment links | PayPal, Venmo, Cash App, Revolut, Wise, UPI, bank transfer and crypto wallets. Buttons open each app; details have copy buttons. The page never takes the payment |
| Divider, Spacer | Layout helpers |

### vCard Plus and Save contact [#vcard-plus-and-save-contact]

**Save contact** downloads a vCard 3.0 file (`.vcf`) that phones open in their contacts app. It contains the name, company, job title, phones, emails, website, address, bio, the page's social profiles and the photo. A photo uploaded to QRdx storage is embedded in the file when it is 1 MB or smaller; larger photos, and photos linked from other sites, are included as a link, because QRdx never downloads images from other sites. **Share** opens the phone's share sheet, or copies the page link on computers. To put the card on an NFC card as well, see [NFC business cards](https://qrdx.dev/docs/nfc#nfc-business-cards).

## What visitors get [#what-visitors-get]

- Fast, server-rendered pages built for phones. The only QRdx script on the page counts views and taps for your **Page activity** card; there is no product analytics and no support widget. Your own [tracking pixels](https://qrdx.dev/docs/tracking-and-conversions#tracking-pixels-on-hosted-pages-pro) load only if you add them to the code.
- Hidden from search engines unless you turn on **Show in search engines**.
- Share previews (title, description, image) for chat apps and social networks. Password-protected codes never reveal page details in previews.
- A small **Report abuse** link on every page, including white-label pages.

Password protection, start and end dates, scan limits and pausing from [code controls](https://qrdx.dev/docs/code-controls) apply to the page and its **Save contact** file too, also when someone opens the page link directly.

## Limits and plans [#limits-and-plans]

| | Free | Pro | Business |
| --- | --- | --- | --- |
| Hosted pages | 3 | Unlimited | Unlimited |
| "Made with QRdx" footer | Shown | Removed | Removed |
| White-label (your logo as the browser icon, no QRdx branding) | No | No | Yes |
| Custom CSS | No | No | Yes |

White-label and custom CSS are under the QRdx commercial license. A self-hosted QRdx server needs a license key that QRdx issues with an enterprise agreement (`QRDX_EE_LICENSE`) to turn them on; see [Self-hosting](https://qrdx.dev/docs/self-hosting#optional-services). Without one, every page shows QRdx's default branding and no custom CSS, and keeps working.

Limits only stop you from creating new pages. Pages you already have keep working on every plan, including after a downgrade. After a downgrade from Business, a page's custom CSS is no longer applied, and the editor refuses to publish that page again until you remove the CSS in its **Settings**.

### Custom CSS [#custom-css]

On Business, write plain CSS in **Settings** → **Custom CSS**. Rules only apply inside your page: every selector is scoped to the page content, and each block can be targeted with `.lp-block-<type>`, for example `.lp-block-links a` or `.lp-block-contact h1`. For safety, CSS can't load files (`url()`, `@import`, `@font-face`), can't use backslash escapes, and supports the `@media`, `@supports`, `@container` and `@keyframes` at-rules only.

## For developers [#for-developers]

A code's `kind` in the [REST API](https://qrdx.dev/docs/developers/api/update-code) is `redirect` or `page`, and `PATCH /v1/codes/{id}` switches between them the way **Change type** does. Pages themselves are built in the editor; the API doesn't edit blocks.

## Related [#related]

- [Menus, coupons, events and forms](https://qrdx.dev/docs/forms-and-pages): the blocks for restaurants, offers, events and feedback
- [Product pages and GS1 Digital Link](https://qrdx.dev/docs/product-pages)
- [Files](https://qrdx.dev/docs/files): PDFs, galleries, audio and video on a page
- [Create a mobile page](https://qrdx.dev/docs/help/pages-and-forms/create-a-page)
