New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee


  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

AI in Chargebee


  • Chargebee Copilot
  • Chargebee Model Context Protocol (MCP) Server

Developer Resources


  • Developer Resources Overview
  • Articles and FAQ

Product Catalog


  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions


  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers


  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Entitlements


  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
  • Articles and FAQ

Usage Based Billing


  • Understanding Usages
  • Setting up Usage Based Billing
  • Usage Alerts
  • Metered Billing
  • Articles and FAQ

Chargebee CPQ


  • Chargebee CPQ
  • Chargebee CPQ for Salesforce
  • Chargebee CPQ for HubSpot

Invoices, Credit Notes, and Quotes


  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes


  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Managing Payments with Chargebee.js
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • Approvals
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Multi Business Entity


  • Multi Business Entity Overview
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions


  • Overview
  • Omnichannel Subscriptions
  • Omnichannel One-Time Orders
  • Mobile Subscriptions (Legacy)

Reports and Analytics


  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations


  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • eInvoicing
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Ecommerce Management
  • Articles and FAQ

Data Privacy & Security


  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations


  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  2. Site Configuration
  3. Articles and FAQ
  4. Custom Fields & Metadata
  1. Billing
  2. Site Configuration
  3. Articles and FAQ
  4. Custom Fields & Metadata

How to pass values to custom fields using in-app scripts?

Problem Statement

You want to know how to pass values to custom fields using in-app scripts.

Solution

Scope

Does the In-app Script allow me to pass a value to the Custom Fields?

Does the In-app Script allow me to pass the customer's email to the Checkout or portal?

Summary

In Chargebee, it is possible to pre-fill the custom fields in Checkout and Portal either with the drop-in script or by using Chargebee's API.

Solution

Via Drop-in Script

Once the custom field is created, all the parameters for the Customer can be passed using the setCustomer function. This information will be passed to checkout and will be prefilled - including the custom field.

You can use the SetCustomdata function to pass the Subscription level custom fields. To know more about the Checkout page script.

Please refer to the example shown under drop-in script customizations from here.

Via API

Custom field parameters start only with 'cf' as shown in the image below

image

Sample Custom filed format for which the parameters need to be passed.

You can view the custom fields format from this link, and navigate to Checkout new subscription > Input parameter > Customer.

image

More on API docs for hosted pages here.

via Hosted page URL

In a hosted page URL for a plan, you can pass the custom field as a parameter and embed it in the checkout button on your page.

Refer to the Pre-filling/Passing custom fields to hosted pages (via Plan URL) document to know more.

You can also read more about Custom Fields.

Related Links:

Is it possible to filter set custom fields as filters via the APIs?

Can custom fields be displayed in the customer portal and checkout pages?

How to display custom fields on invoices

How do I display custom fields to customers?

Related Articles

How can I display the custom fields on an invoice?
Can custom fields be displayed in the customer portal and checkout pages?
Custom field does not display on the invoice.
Custom fields in invoice customisation not configured
How to create a custom field for password?
'Error message: "There were errors while submitting" "cannot be blank".drop-in script with custom fields'

Show more

Was this article helpful?