Stay organized with collectionsSave and categorize content based on your preferences.
Firebase Security Rules
plat_iosplat_androidplat_webplat_flutterplat_node
Use our flexible, extensible Firebase Security Rules to
secure your data inCloud Firestore,Firebase Realtime Database, andCloud Storage.
Firebase Security Rulesstand between your data and malicious users. You can write simple or
complex rules that protect your app's data to the level of granularity that
your specific app requires.
Firebase Security Rulesleverage
extensible, flexible configuration languages to define what data your users
can access forRealtime Database,Cloud Firestore, andCloud Storage.Firebase Realtime DatabaseSecurity Rulesleverage JSON in rule definitions, whileCloud FirestoreSecurity RulesandFirebase Security RulesforCloud Storageleverage a unique
language built to accommodate more complex rules-specific structures.
Learn more about how to set upRulesfor the specific Firebase products
you use in your app, and howRulesbehavior differs across Firebase
products.
Write custom rules that make sense for your app's structure and behavior.Rulesuse languages that allow you to leverage your own data
to authorize access.
Granularity
Your rules can be as broad or as narrow as you need.
Independent security
BecauseRulesare defined outside of your app (in theFirebaseconsole orFirebaseCLI), clients
aren't responsible for enforcing security, bugs don't compromise data, and
your data is always protected.
How do they work?
Firebase Security Ruleswork by matching a pattern against database paths, and then applying
custom conditions to allow access to data at those paths. AllRulesacross Firebase products have a path-matching component and a conditional
statement allowing read or write access. You must defineRulesfor
each Firebase product you use in your app.
ForCloud FirestoreandCloud Storage,Rulesuse the following
syntax:
service <<name>> {
// Match the resource path.
match <<path>> {
// Allow the request if the following conditions are true.
allow <<methods>> : if <<condition>>
}
}
ForRealtime Database, JSON-basedRulesuse the following syntax:
{
"rules": {
"<<path>>": {
// Allow the request if the condition for each method is true.
".read": <<condition>>,
".write": <<condition>>
}
}
}
Rulesare applied asORstatements, notANDstatements.
Consequently, if multiple rules match a path, and any of the matched
conditions grants access,Rulesgrant access to the data at that
path. Therefore, if a broad rule grants access to data, you can't restrict with
a more specific rule. You can, however, avoid this problem by making sure yourRulesdon't overlap too much.Firebase Security Rulesflag overlaps in your
matched paths as compiler warnings.
Firebase Security Rulescan also leverageAuthenticationto grant user-based permissions, and the
conditions you set can be very basic or incredibly complex. Learn more
aboutRuleslanguageandbehaviorbefore you start writingRules.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["Firebase Security Rules \nplat_ios plat_android plat_web plat_flutter plat_node \nUse our flexible, extensible Firebase Security Rules to\nsecure your data in Cloud Firestore, Firebase Realtime Database, and\nCloud Storage.\n\nFirebase Security Rules stand between your data and malicious users. You can write simple or\ncomplex rules that protect your app's data to the level of granularity that\nyour specific app requires.\n\nFirebase Security Rules leverage\nextensible, flexible configuration languages to define what data your users\ncan access for Realtime Database, Cloud Firestore, and Cloud Storage.\nFirebase Realtime Database Security Rules leverage JSON in rule definitions, while\nCloud Firestore Security Rules and Firebase Security Rules for Cloud Storage leverage a unique\nlanguage built to accommodate more complex rules-specific structures.\n\nLearn more about how to set up Rules for the specific Firebase products\nyou use in your app, and how Rules behavior differs across Firebase\nproducts.\n\n[Get started](/docs/rules/get-started)\n\nKey capabilities\n\n|----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Flexibility | Write custom rules that make sense for your app's structure and behavior. Rules use languages that allow you to leverage your own data to authorize access. |\n| Granularity | Your rules can be as broad or as narrow as you need. |\n| Independent security | Because Rules are defined outside of your app (in the Firebase console or Firebase CLI), clients aren't responsible for enforcing security, bugs don't compromise data, and your data is always protected. |\n\nHow do they work?\n\nFirebase Security Rules work by matching a pattern against database paths, and then applying\ncustom conditions to allow access to data at those paths. All Rules\nacross Firebase products have a path-matching component and a conditional\nstatement allowing read or write access. You must define Rules for\neach Firebase product you use in your app.\n\nFor Cloud Firestore and Cloud Storage, Rules use the following\nsyntax: \n\n service \u003c\u003cname\u003e\u003e {\n // Match the resource path.\n match \u003c\u003cpath\u003e\u003e {\n // Allow the request if the following conditions are true.\n allow \u003c\u003cmethods\u003e\u003e : if \u003c\u003ccondition\u003e\u003e\n }\n }\n\nFor Realtime Database, JSON-based Rules use the following syntax: \n\n {\n \"rules\": {\n \"\u003c\u003cpath\u003e\u003e\": {\n // Allow the request if the condition for each method is true.\n \".read\": \u003c\u003ccondition\u003e\u003e,\n \".write\": \u003c\u003ccondition\u003e\u003e\n }\n }\n }\n\nRules are applied as `OR` statements, not `AND` statements.\nConsequently, if multiple rules match a path, and any of the matched\nconditions grants access, Rules grant access to the data at that\npath. Therefore, if a broad rule grants access to data, you can't restrict with\na more specific rule. You can, however, avoid this problem by making sure your\nRules don't overlap too much. Firebase Security Rules flag overlaps in your\nmatched paths as compiler warnings.\n\nFirebase Security Rules can also leverage Authentication to grant user-based permissions, and the\nconditions you set can be very basic or incredibly complex. Learn more\nabout Rules [language](/docs/rules/rules-language) and [behavior](/docs/rules/rules-behavior)\nbefore you start writing Rules.\n\nImplementation path\n\n|---|-------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| | Integrate the product SDKs | Set up [Cloud Firestore](/docs/firestore), [Cloud Storage](/docs/storage), or [Realtime Database](/docs/database) for your app. |\n| | Write your Firebase Security Rules | Learn more about [how Rules work](/docs/rules/rules-behavior) and [set up some basic Rules](/docs/rules/basics) |\n| | Test your Firebase Security Rules | Use the Realtime Database and Cloud Firestore emulators to test your app's behavior and validate your rules before you deploy them to production. |\n| | Deploy your Firebase Security Rules | Use the Firebase console or the Firebase CLI to deploy your rules to production. |\n\nNext steps\n\n- [Understand the Firebase Security Rules language](/docs/rules/rules-language).\n- Learn more about [how Firebase Security Rules work](/docs/rules/rules-behavior).\n- Explore the [common mistakes you should avoid](/docs/rules/insecure-rules)."]]