Introduction

In Android XML, the percent symbol can mean two very different things depending on context. In string resources, it can be part of a formatted placeholder or a literal percent sign. In layout files, you generally cannot write dimensions as 50% directly the way you might in CSS. The correct solution depends on whether you are formatting text or building a percentage-based layout.

Percent in String Resources

If the problem is showing a literal percent sign in a string resource, the answer depends on whether the string is formatted.

A simple literal string can often just contain % directly:

<string name="battery_label">Battery 80%</string>

But if the string uses formatting placeholders, % becomes part of the format syntax and must be handled carefully.

Example with a numeric placeholder:

<string name="progress_label">Progress %1$d%%</string>

Why %%?

• '%1$d means “insert the first integer argument”'
• '%% means “render a literal percent sign”'

Usage in Kotlin:

val label = getString(R.string.progress_label, 80)
println(label) // Progress 80%

If you forget the second %, Android treats the string as malformed format text.

Percent in Layout Dimensions

Android XML layouts do not generally support writing this directly:

android:layout_width="50%"

That is not standard Android layout syntax. Instead, percentage-based sizing is usually done through ConstraintLayout.

Use ConstraintLayout for Percentage Width or Height

With ConstraintLayout, one common pattern is to set the dimension to 0dp and then specify the percentage.

1<androidx.constraintlayout.widget.ConstraintLayout
2    xmlns:android="http://schemas.android.com/apk/res/android"
3    xmlns:app="http://schemas.android.com/apk/res-auto"
4    android:layout_width="match_parent"
5    android:layout_height="match_parent">
6
7    <View
8        android:id="@+id/box"
9        android:layout_width="0dp"
10        android:layout_height="100dp"
11        android:background="@android:color/holo_blue_light"
12        app:layout_constraintStart_toStartOf="parent"
13        app:layout_constraintEnd_toEndOf="parent"
14        app:layout_constraintTop_toTopOf="parent"
15        app:layout_constraintWidth_percent="0.5" />
16
17</androidx.constraintlayout.widget.ConstraintLayout>

Here, the view takes 50 percent of the parent width. The value is written as 0.5, not 50%.

Use Guidelines for Positioning by Percentage

Another common percent-based tool is a guideline.

1<androidx.constraintlayout.widget.Guideline
2    android:id="@+id/guideline"
3    android:layout_width="wrap_content"
4    android:layout_height="wrap_content"
5    android:orientation="vertical"
6    app:layout_constraintGuide_percent="0.3" />

This places the guideline at 30 percent of the parent width. Other views can then constrain themselves relative to that guideline.

This is often better than trying to make every view percentage-sized directly.

Do Not Confuse Percent Text With Percent Layouts

These are different problems:

• “I want to show 75% on screen” is a string-formatting question.
• “I want this view to occupy 75 percent of the width” is a layout question.

A lot of confusion comes from mixing those two uses of the percent symbol.

Example: Progress Text and Layout Together

<string name="storage_used">Used %1$d%%</string>

And in layout:

app:layout_constraintWidth_percent="0.75"

These may both describe 75 percent conceptually, but they are represented differently because one is text formatting and the other is layout behavior.

Why Android Does Not Use CSS-Style 50%

Android layout XML is not HTML or CSS. Its attributes are implemented by Android view classes and layout managers, each with their own parsing rules.

That is why you see dimensions such as:

• 'wrap_content'
• 'match_parent'
• '16dp'

but not ordinary CSS-style percentage values for general layout attributes.

When percentage behavior exists, it is usually exposed through a layout-specific attribute such as layout_constraintWidth_percent.

Common Pitfalls

A common mistake is writing android:layout_width="50%" and expecting Android to parse it like CSS. Standard Android layouts do not work that way.

Another issue is forgetting to escape a literal percent sign in formatted string resources. If the string contains placeholders, use %% for a literal percent symbol.

Developers also sometimes use ConstraintLayout percent attributes but forget that the width or height often needs to be 0dp so the constraint system can control that dimension.

Finally, do not mix up display text percentages with layout percentages. They solve different problems and use different syntax.

Summary

• In string resources, % is part of formatting syntax and %% renders a literal percent sign.
• In Android layouts, you generally cannot write dimensions as 50% directly.
• For percentage-based sizing, use ConstraintLayout attributes such as layout_constraintWidth_percent.
• For percentage-based positioning, use guidelines with layout_constraintGuide_percent.
• Separate the text-formatting problem from the layout-sizing problem before choosing the fix.